FLOW Framework: Find · Leverage · Optimize · Win
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.
Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow
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:
claude-seo run 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. |
1---
2name: seo-flow
3description: >
4 FLOW framework integration: evidence-led SEO using the Find → Leverage →
5 Optimize → Win loop. Surfaces stage-specific AI prompts from the FLOW
6 knowledge base (41 prompts, CC BY 4.0). Use when user says "FLOW", "FLOW
7 framework", "seo flow", "evidence-led SEO", "find leverage optimize win",
8 or wants stage-specific SEO prompts.
9user-invocable: true
10argument-hint: "[stage] [url|topic]"
11license: MIT
12metadata:
13 source: https://skillmd.com/skills/agricidaniel/seo-flow
14 author: AgriciDaniel
15 version: "2.2.5"
16 category: seo
17---
18
19# FLOW Framework: Find · Leverage · Optimize · Win
20
21FLOW is an evidence-led SEO operating model built for the AI-search era. Claude SEO
22integrates the FLOW prompt library (41 prompts across 5 stages) so every analysis can
23be driven by structured, evidence-backed AI prompts rather than improvised queries.
24
25> Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow
26
27**Runtime context:** Load `references/flow-framework.md` on every `/seo flow` activation.
28Load prompt files on demand, only for the stage the user requests.
29
30---
31
32## Commands
33
34| Command | What it does |
35|---------|-------------|
36| `/seo flow` | Show FLOW overview + stage menu |
37| `/seo flow find [url\|topic]` | Find-stage: keyword research, gap analysis, SERP intent mapping (5 prompts) |
38| `/seo flow leverage [url]` | Leverage-stage: backlink strategy, off-site authority (1 prompt) |
39| `/seo flow optimize [url]` | Optimize-stage: select 2-3 most relevant of 21 prompts based on context |
40| `/seo flow win [url]` | Win-stage: BOFU, conversion rate, dual-surface scorecard (3 prompts) |
41| `/seo flow local [url]` | Local-stage: GBP optimization, meta, title tags, local audits (11 prompts) |
42| `/seo flow prompts` | Full index of all 41 prompts (stage, name, trigger conditions) |
43| `/seo flow sync` | Pull latest prompt files from github.com/AgriciDaniel/flow |
44
45---
46
47## Orchestration Logic
48
49### On `/seo flow` (no sub-command)
501. Read `references/flow-framework.md`
512. Show the FLOW stage overview with a one-line description of each stage
523. Ask: which stage matches the user's current situation?
53
54### On `/seo flow find [url|topic]`
551. Read all files in `references/prompts/find/`
562. Apply each prompt to the URL or topic
573. Cross-reference: "For deeper SERP clustering, see `/seo cluster <seed-keyword>`"
58
59### On `/seo flow leverage [url]`
601. Read the file in `references/prompts/leverage/`
612. Apply to the URL's current backlink context
623. Cross-reference: "For raw backlink data, see `/seo backlinks <url>`"
63
64### On `/seo flow optimize [url]`
651. Read all file names in `references/prompts/optimize/`
662. Read prior analysis context (URL, industry vertical, any prior skill output in conversation)
673. Select 2-3 most relevant prompts; load only those files
684. Apply selected prompts; note the others are accessible via `/seo flow prompts`
695. Cross-reference: "For full content quality analysis, see `/seo content <url>` and `/seo geo <url>`"
70
71### On `/seo flow win [url]`
721. Read all files in `references/prompts/win/`
732. Apply each prompt to the URL's conversion and BOFU context
743. Cross-reference: "For SXO persona scoring, see `/seo sxo <url>`"
75
76### On `/seo flow local [url]`
771. Read all files in `references/prompts/local/`
782. Apply to the URL's local SEO context
793. Cross-reference: "For full local SEO analysis, see `/seo local <url>` and `/seo maps [command]`"
80
81### On `/seo flow prompts`
821. Read `references/prompts/README.md`
832. Display the full index: all 41 prompts with stage, name, trigger conditions
84
85### On `/seo flow sync`
861. Run: `claude-seo run sync_flow.py`
872. Display the JSON summary (files added, updated, unchanged)
883. Show attribution notice after sync completes
89
90---
91
92## Context Matching (Optimize stage)
93
94The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:
95
961. **Industry vertical** (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness)
972. **Prior skill output** (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts)
983. **URL signals** (product pages → conversion; blog → freshness + authority)
99
100Always surface exactly 2-3 prompts. State which prompts you chose and why.
101
102---
103
104## Reference Files
105
106Load on-demand, do NOT load all at startup:
107- `references/flow-framework.md`: FLOW operating model (load on every `/seo flow` activation)
108- `references/bibliography.md`: Evidence sources; load when citing studies or statistics
109- `references/prompts/README.md`: Prompt index; load for `/seo flow prompts`
110- `references/prompts/find/`: 5 prompts; load for `/seo flow find`
111- `references/prompts/leverage/`: 1 prompt; load for `/seo flow leverage`
112- `references/prompts/optimize/`: 21 prompts; load selectively for `/seo flow optimize`
113- `references/prompts/win/`: 3 prompts; load for `/seo flow win`
114- `references/prompts/local/`: 11 prompts; load for `/seo flow local`
115
116---
117
118## Attribution
119
120Every `/seo flow` activation (any sub-command) outputs before analysis:
121
122```
123Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow
124```
125
126Do not omit or modify the attribution.
127
128---
129
130## Error Handling
131
132| Scenario | Action |
133|----------|--------|
134| `references/flow-framework.md` missing | "FLOW reference files not synced. Run: `/seo flow sync`" |
135| Prompt file missing | "Run `/seo flow sync` to pull the latest prompts from the FLOW repo." |
136| `sync_flow.py` network error | Display the script's stderr. Check rate limits: `gh api rate_limit`. |
137| `sync_flow.py` auth error | Run `gh auth login` then retry. |