seo-flow

Original：🇺🇸 English

Translated

FLOW framework integration — evidence-led SEO using the Find → Leverage → Optimize → Win loop. Surfaces stage-specific AI prompts from the FLOW knowledge base (41 prompts, CC BY 4.0). Use when user says "FLOW", "FLOW framework", "seo flow", "evidence-led SEO", "find leverage optimize win", or wants stage-specific SEO prompts.

6installs

Sourceagricidaniel/claude-seo

Added on2026-04-27

NPX Install

npx skill4agent add agricidaniel/claude-seo seo-flow

SKILL.md Content

View Translation Comparison →

FLOW Framework — Find · Leverage · Optimize · Win

Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow

FLOW is an evidence-led SEO operating model built for the AI-search era. Claude SEO integrates the FLOW prompt library (41 prompts across 5 stages) so every analysis can be driven by structured, evidence-backed AI prompts rather than improvised queries.

Runtime context: Load

references/flow-framework.md

on every

/seo flow

activation. Load prompt files on demand — only for the stage the user requests.

Commands

Command	What it does
`/seo flow`	Show FLOW overview + stage menu
`/seo flow find [url\|topic]`	Find-stage: keyword research, gap analysis, SERP intent mapping (5 prompts)
`/seo flow leverage [url]`	Leverage-stage: backlink strategy, off-site authority (1 prompt)
`/seo flow optimize [url]`	Optimize-stage: select 2-3 most relevant of 21 prompts based on context
`/seo flow win [url]`	Win-stage: BOFU, conversion rate, dual-surface scorecard (3 prompts)
`/seo flow local [url]`	Local-stage: GBP optimization, meta, title tags, local audits (11 prompts)
`/seo flow prompts`	Full index of all 41 prompts — stage, name, trigger conditions
`/seo flow sync`	Pull latest prompt files from github.com/AgriciDaniel/flow

Orchestration Logic

On

/seo flow

(no sub-command)

Read
```
references/flow-framework.md
```
Show the FLOW stage overview with a one-line description of each stage
Ask: which stage matches the user's current situation?

On

/seo flow find [url|topic]

Read all files in
```
references/prompts/find/
```
Apply each prompt to the URL or topic
Cross-reference: "For deeper SERP clustering, see
```
/seo cluster <seed-keyword>
```
"

On

/seo flow leverage [url]

Read the file in
```
references/prompts/leverage/
```
Apply to the URL's current backlink context
Cross-reference: "For raw backlink data, see
```
/seo backlinks <url>
```
"

On

/seo flow optimize [url]

Read all file names in
```
references/prompts/optimize/
```
Read prior analysis context (URL, industry vertical, any prior skill output in conversation)
Select 2-3 most relevant prompts; load only those files
Apply selected prompts; note the others are accessible via
```
/seo flow prompts
```
Cross-reference: "For full content quality analysis, see
```
/seo content <url>
```
and
```
/seo geo <url>
```
"

On

/seo flow win [url]

Read all files in
```
references/prompts/win/
```
Apply each prompt to the URL's conversion and BOFU context
Cross-reference: "For SXO persona scoring, see
```
/seo sxo <url>
```
"

On

/seo flow local [url]

Read all files in
```
references/prompts/local/
```
Apply to the URL's local SEO context
Cross-reference: "For full local SEO analysis, see
```
/seo local <url>
```
and
```
/seo maps [command]
```
"

On

/seo flow prompts

Read
```
references/prompts/README.md
```
Display the full index: all 41 prompts with stage, name, trigger conditions

On

/seo flow sync

Run:
```
python scripts/sync_flow.py
```
Display the JSON summary (files added, updated, unchanged)
Show attribution notice after sync completes

Context Matching (Optimize stage)

The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:

Industry vertical (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness)
Prior skill output (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts)
URL signals (product pages → conversion; blog → freshness + authority)

Always surface exactly 2-3 prompts. State which prompts you chose and why.

Reference Files

Load on-demand — do NOT load all at startup:

```
references/flow-framework.md
```
— FLOW operating model (load on every
```
/seo flow
```
activation)
```
references/bibliography.md
```
— Evidence sources; load when citing studies or statistics

references/prompts/README.md

— Prompt index; load for

/seo flow prompts

```
references/prompts/find/
```
— 5 prompts; load for
```
/seo flow find
```

references/prompts/leverage/

— 1 prompt; load for

/seo flow leverage

references/prompts/optimize/

— 21 prompts; load selectively for

/seo flow optimize

```
references/prompts/win/
```
— 3 prompts; load for
```
/seo flow win
```

references/prompts/local/

— 11 prompts; load for

/seo flow local

Attribution

Every

/seo flow

activation (any sub-command) outputs before analysis:

Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow

Do not omit or modify the attribution.

Error Handling

Scenario	Action
`references/flow-framework.md` missing	"FLOW reference files not synced. Run: `/seo flow sync` "
Prompt file missing	"Run `/seo flow sync` to pull the latest prompts from the FLOW repo."
`sync_flow.py` network error	Display the script's stderr. Check rate limits: `gh api rate_limit` .
`sync_flow.py` auth error	Run `gh auth login` then retry.

seo-flow

NPX Install

Tags

SKILL.md Content

FLOW Framework — Find · Leverage · Optimize · Win

Commands

Orchestration Logic

On
`/seo flow`
(no sub-command)

On
`/seo flow find [url|topic]`

On
`/seo flow leverage [url]`

On
`/seo flow optimize [url]`

On
`/seo flow win [url]`

On
`/seo flow local [url]`

On
`/seo flow prompts`

On
`/seo flow sync`

Context Matching (Optimize stage)

Reference Files

Attribution

Error Handling