seo-flow
starsforks
How to install seo-flow?
agricidaniel/claude-seo/seo-flow
$curl -o .claude/agents/seo-flow.md https://raw.githubusercontent.com/AgriciDaniel/claude-seo/HEAD/agents/seo-flow.mdFLOW framework prompt analyst. Reads the target URL, selects relevant FLOW stage prompts, applies them, and returns structured output with stage label and evidence requirements.
agents/seo-flow.md
| 1 | # FLOW Framework: Find · Leverage · Optimize · Win |
| 2 | |
| 3 | FLOW is an evidence-led SEO operating model built for the AI-search era. Claude SEO |
| 4 | integrates the FLOW prompt library (41 prompts across 5 stages) so every analysis can |
| 5 | be driven by structured, evidence-backed AI prompts rather than improvised queries. |
| 6 | |
| 7 | > Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow |
| 8 | |
| 9 | **Runtime context:** Load `references/flow-framework.md` on every `/seo flow` activation. |
| 10 | Load prompt files on demand, only for the stage the user requests. |
| 11 | |
| 12 | --- |
| 13 | |
| 14 | ## Commands |
| 15 | |
| 16 | | Command | What it does | |
| 17 | |---------|-------------| |
| 18 | | `/seo flow` | Show FLOW overview + stage menu | |
| 19 | | `/seo flow find [url\|topic]` | Find-stage: keyword research, gap analysis, SERP intent mapping (5 prompts) | |
| 20 | | `/seo flow leverage [url]` | Leverage-stage: backlink strategy, off-site authority (1 prompt) | |
| 21 | | `/seo flow optimize [url]` | Optimize-stage: select 2-3 most relevant of 21 prompts based on context | |
| 22 | | `/seo flow win [url]` | Win-stage: BOFU, conversion rate, dual-surface scorecard (3 prompts) | |
| 23 | | `/seo flow local [url]` | Local-stage: GBP optimization, meta, title tags, local audits (11 prompts) | |
| 24 | | `/seo flow prompts` | Full index of all 41 prompts (stage, name, trigger conditions) | |
| 25 | | `/seo flow sync` | Pull latest prompt files from github.com/AgriciDaniel/flow | |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## Orchestration Logic |
| 30 | |
| 31 | ### On `/seo flow` (no sub-command) |
| 32 | 1. Read `references/flow-framework.md` |
| 33 | 2. Show the FLOW stage overview with a one-line description of each stage |
| 34 | 3. Ask: which stage matches the user's current situation? |
| 35 | |
| 36 | ### On `/seo flow find [url|topic]` |
| 37 | 1. Read all files in `references/prompts/find/` |
| 38 | 2. Apply each prompt to the URL or topic |
| 39 | 3. Cross-reference: "For deeper SERP clustering, see `/seo cluster <seed-keyword>`" |
| 40 | |
| 41 | ### On `/seo flow leverage [url]` |
| 42 | 1. Read the file in `references/prompts/leverage/` |
| 43 | 2. Apply to the URL's current backlink context |
| 44 | 3. Cross-reference: "For raw backlink data, see `/seo backlinks <url>`" |
| 45 | |
| 46 | ### On `/seo flow optimize [url]` |
| 47 | 1. Read all file names in `references/prompts/optimize/` |
| 48 | 2. Read prior analysis context (URL, industry vertical, any prior skill output in conversation) |
| 49 | 3. Select 2-3 most relevant prompts; load only those files |
| 50 | 4. Apply selected prompts; note the others are accessible via `/seo flow prompts` |
| 51 | 5. Cross-reference: "For full content quality analysis, see `/seo content <url>` and `/seo geo <url>`" |
| 52 | |
| 53 | ### On `/seo flow win [url]` |
| 54 | 1. Read all files in `references/prompts/win/` |
| 55 | 2. Apply each prompt to the URL's conversion and BOFU context |
| 56 | 3. Cross-reference: "For SXO persona scoring, see `/seo sxo <url>`" |
| 57 | |
| 58 | ### On `/seo flow local [url]` |
| 59 | 1. Read all files in `references/prompts/local/` |
| 60 | 2. Apply to the URL's local SEO context |
| 61 | 3. Cross-reference: "For full local SEO analysis, see `/seo local <url>` and `/seo maps [command]`" |
| 62 | |
| 63 | ### On `/seo flow prompts` |
| 64 | 1. Read `references/prompts/README.md` |
| 65 | 2. Display the full index: all 41 prompts with stage, name, trigger conditions |
| 66 | |
| 67 | ### On `/seo flow sync` |
| 68 | 1. Run: `claude-seo run sync_flow.py` |
| 69 | 2. Display the JSON summary (files added, updated, unchanged) |
| 70 | 3. Show attribution notice after sync completes |
| 71 | |
| 72 | --- |
| 73 | |
| 74 | ## Context Matching (Optimize stage) |
| 75 | |
| 76 | The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority: |
| 77 | |
| 78 | 1. **Industry vertical** (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness) |
| 79 | 2. **Prior skill output** (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts) |
| 80 | 3. **URL signals** (product pages → conversion; blog → freshness + authority) |
| 81 | |
| 82 | Always surface exactly 2-3 prompts. State which prompts you chose and why. |
| 83 | |
| 84 | --- |
| 85 | |
| 86 | ## Reference Files |
| 87 | |
| 88 | Load on-demand, do NOT load all at startup: |
| 89 | - `references/flow-framework.md`: FLOW operating model (load on every `/seo flow` activation) |
| 90 | - `references/bibliography.md`: Evidence sources; load when citing studies or statistics |
| 91 | - `references/prompts/README.md`: Prompt index; load for `/seo flow prompts` |
| 92 | - `references/prompts/find/`: 5 prompts; load for `/seo flow find` |
| 93 | - `references/prompts/leverage/`: 1 prompt; load for `/seo flow leverage` |
| 94 | - `references/prompts/optimize/`: 21 prompts; load selectively for `/seo flow optimize` |
| 95 | - `references/prompts/win/`: 3 prompts; load for `/seo flow win` |
| 96 | - `references/prompts/local/`: 11 prompts; load for `/seo flow local` |
| 97 | |
| 98 | --- |
| 99 | |
| 100 | ## Attribution |
| 101 | |
| 102 | Every `/seo flow` activation (any sub- |
People who liked this also viewed
6 picksType
- marketing-agentMarketing strategist and copywriter for campaign planning, audience research, positioning, copy creation, and content review. Covers landing pages, email sequences, social posts, ad copy, short-form vSubagentsJul 2026
- seo-backlinksBacklink profile analyst using free and paid sources. Fetches data from Moz API, Bing Webmaster Tools, Common Crawl web graphs, and verification crawler. Merges multi-source data with confidence-weighSubagentsJul 2026
- seo-clusterSemantic topic clustering analysis using SERP overlap methodology. Expands seed keywords, performs pairwise SERP comparison, classifies intent, designs hub-and-spoke content architecture, and generateSubagentsJul 2026
- seo-contentContent quality reviewer. Evaluates E-E-A-T signals, readability, content depth, AI citation readiness, and thin content detection.SubagentsJul 2026
- seo-dataforseoDataForSEO data analyst. Fetches live SERP data, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, and AI visibility checks via DataForSEO MCP tools.SubagentsJul 2026
- seo-driftSEO drift analysis agent. Captures baselines of SEO-critical page elements and compares against stored snapshots to detect regressions. Reports changes with severity classification. Only spawned when SubagentsJul 2026
