AgentAlley
Connect your AISubmit
Submit

FLOW Framework SEO

FLOW Framework: Find · Leverage · Optimize · Win

by AgriciDaniel · MIT license · ★ 17,394 on GitHub · updated Sep 11

FLOW Framework: Find · Leverage · Optimize · Win cover

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).

---
name: seo-flow
description: >
  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.
user-invocable: true
argument-hint: "[stage] [url|topic]"
license: MIT
metadata:
  author: AgriciDaniel
  version: "2.3.1"
  category: seo
---

# FLOW Framework: Find · Leverage · Optimize · Win

Overview

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.

The SKILL.md below is the copy AgentAlley read and checked. The repo has changed it since; the other files are from commit e77e783.

Manual install (npx, ZIP)
Claude Codenpx skills add AgriciDaniel/claude-seo --skill seo-flow -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/AgriciDaniel/claude-seo/tar.gz/e77e783e38ee \ | tar -xz -C ~/.claude/skills --strip-components=2 claude-seo-e77e783e38ee/skills/seo-flow
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/a5f68354fa273243f822/seo-flow.zip" -OutFile "$env:TEMP\seo-flow.zip"; Expand-Archive "$env:TEMP\seo-flow.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md5.5 KB
  • references/45 files · 108.4 KB
Read the files here
AgriciDaniel/e77e78346 files
Shared references1SKILL.md reads these from elsewhere in the repo. Not in the ZIP.Get them on GitHub ↗
SKILL.md
Show the full text137 lines
seo-flow/SKILL.md137 lines · 5.5 KB
Outline
RawView on GitHub

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)
  1. Read references/flow-framework.md
  2. Show the FLOW stage overview with a one-line description of each stage
  3. Ask: which stage matches the user's current situation?
On /seo flow find [url|topic]
  1. Read all files in references/prompts/find/
  2. Apply each prompt to the URL or topic
  3. Cross-reference: "For deeper SERP clustering, see /seo cluster <seed-keyword>"
On /seo flow leverage [url]
  1. Read the file in references/prompts/leverage/
  2. Apply to the URL's current backlink context
  3. Cross-reference: "For raw backlink data, see /seo backlinks <url>"
On /seo flow optimize [url]
  1. Read all file names in references/prompts/optimize/
  2. Read prior analysis context (URL, industry vertical, any prior skill output in conversation)
  3. Select 2-3 most relevant prompts; load only those files
  4. Apply selected prompts; note the others are accessible via /seo flow prompts
  5. Cross-reference: "For full content quality analysis, see /seo content <url> and /seo geo <url>"
On /seo flow win [url]
  1. Read all files in references/prompts/win/
  2. Apply each prompt to the URL's conversion and BOFU context
  3. Cross-reference: "For SXO persona scoring, see /seo sxo <url>"
On /seo flow local [url]
  1. Read all files in references/prompts/local/
  2. Apply to the URL's local SEO context
  3. Cross-reference: "For full local SEO analysis, see /seo local <url> and /seo maps [command]"
On /seo flow prompts
  1. Read references/prompts/README.md
  2. Display the full index: all 41 prompts with stage, name, trigger conditions
On /seo flow sync
  1. Run: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run sync_flow.py
  2. Display the JSON summary (files added, updated, unchanged)
  3. Show attribution notice after sync completes

Context Matching (Optimize stage)

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

  1. Industry vertical (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness)
  2. Prior skill output (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts)
  3. 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 author: AgriciDaniel
14 version: "2.3.1"
15 category: seo
16---
17 
18# FLOW Framework: Find · Leverage · Optimize · Win
19 
20FLOW is an evidence-led SEO operating model built for the AI-search era. Claude SEO
21integrates the FLOW prompt library (41 prompts across 5 stages) so every analysis can
22be driven by structured, evidence-backed AI prompts rather than improvised queries.
23 
24> Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow
25 
26**Runtime context:** Load `references/flow-framework.md` on every `/seo flow` activation.
27Load prompt files on demand, only for the stage the user requests.
28 
29---
30 
31## Commands
32 
33| Command | What it does |
34|---------|-------------|
35| `/seo flow` | Show FLOW overview + stage menu |
36| `/seo flow find [url\|topic]` | Find-stage: keyword research, gap analysis, SERP intent mapping (5 prompts) |
37| `/seo flow leverage [url]` | Leverage-stage: backlink strategy, off-site authority (1 prompt) |
38| `/seo flow optimize [url]` | Optimize-stage: select 2-3 most relevant of 21 prompts based on context |
39| `/seo flow win [url]` | Win-stage: BOFU, conversion rate, dual-surface scorecard (3 prompts) |
40| `/seo flow local [url]` | Local-stage: GBP optimization, meta, title tags, local audits (11 prompts) |
41| `/seo flow prompts` | Full index of all 41 prompts (stage, name, trigger conditions) |
42| `/seo flow sync` | Pull latest prompt files from github.com/AgriciDaniel/flow |
43 
44---
45 
46## Orchestration Logic
47 
48### On `/seo flow` (no sub-command)
491. Read `references/flow-framework.md`
502. Show the FLOW stage overview with a one-line description of each stage
513. Ask: which stage matches the user's current situation?
52 
53### On `/seo flow find [url|topic]`
541. Read all files in `references/prompts/find/`
552. Apply each prompt to the URL or topic
563. Cross-reference: "For deeper SERP clustering, see `/seo cluster <seed-keyword>`"
57 
58### On `/seo flow leverage [url]`
591. Read the file in `references/prompts/leverage/`
602. Apply to the URL's current backlink context
613. Cross-reference: "For raw backlink data, see `/seo backlinks <url>`"
62 
63### On `/seo flow optimize [url]`
641. Read all file names in `references/prompts/optimize/`
652. Read prior analysis context (URL, industry vertical, any prior skill output in conversation)
663. Select 2-3 most relevant prompts; load only those files
674. Apply selected prompts; note the others are accessible via `/seo flow prompts`
685. Cross-reference: "For full content quality analysis, see `/seo content <url>` and `/seo geo <url>`"
69 
70### On `/seo flow win [url]`
711. Read all files in `references/prompts/win/`
722. Apply each prompt to the URL's conversion and BOFU context
733. Cross-reference: "For SXO persona scoring, see `/seo sxo <url>`"
74 
75### On `/seo flow local [url]`
761. Read all files in `references/prompts/local/`
772. Apply to the URL's local SEO context
783. Cross-reference: "For full local SEO analysis, see `/seo local <url>` and `/seo maps [command]`"
79 
80### On `/seo flow prompts`
811. Read `references/prompts/README.md`
822. Display the full index: all 41 prompts with stage, name, trigger conditions
83 
84### On `/seo flow sync`
851. Run: `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run sync_flow.py`
862. Display the JSON summary (files added, updated, unchanged)
873. Show attribution notice after sync completes
88 
89---
90 
91## Context Matching (Optimize stage)
92 
93The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:
94 
951. **Industry vertical** (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness)
962. **Prior skill output** (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts)
973. **URL signals** (product pages → conversion; blog → freshness + authority)
98 
99Always surface exactly 2-3 prompts. State which prompts you chose and why.
100 
101---
102 
103## Reference Files
104 
105Load on-demand, do NOT load all at startup:
106- `references/flow-framework.md`: FLOW operating model (load on every `/seo flow` activation)
107- `references/bibliography.md`: Evidence sources; load when citing studies or statistics
108- `references/prompts/README.md`: Prompt index; load for `/seo flow prompts`
109- `references/prompts/find/`: 5 prompts; load for `/seo flow find`
110- `references/prompts/leverage/`: 1 prompt; load for `/seo flow leverage`
111- `references/prompts/optimize/`: 21 prompts; load selectively for `/seo flow optimize`
112- `references/prompts/win/`: 3 prompts; load for `/seo flow win`
113- `references/prompts/local/`: 11 prompts; load for `/seo flow local`
114 
115---
116 
117## Attribution
118 
119Every `/seo flow` activation (any sub-command) outputs before analysis:
120 
121```
122Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow
123```
124 
125Do not omit or modify the attribution.
126 
127---
128 
129## Error Handling
130 
131| Scenario | Action |
132|----------|--------|
133| `references/flow-framework.md` missing | "FLOW reference files not synced. Run: `/seo flow sync`" |
134| Prompt file missing | "Run `/seo flow sync` to pull the latest prompts from the FLOW repo." |
135| `sync_flow.py` network error | Display the script's stderr. Check rate limits: `gh api rate_limit`. |
136| `sync_flow.py` auth error | Run `gh auth login` then retry. |
137 
View all files on GitHub →

Details

Updated
Sep 11, 2026
License
MIT
Stars on the repo
★ 17,394
Checked
Source
AgriciDaniel/claude-seo ↗
Creator
AgriciDaniel · 129 listings
View creator

Similar skills

See all →
SkillAgent Browsing AuditorAgriciDaniel/claude-seo · by AgriciDanielAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).★ 17.4k GitHub starsSkillBacklink Profile AnalysisAgriciDaniel/claude-seo · by AgriciDanielBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.★ 17.4k GitHub starsSkillCMS Configuration Helpernowork-studio/notfair-plugin · by nowork-studioConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report.★ 3.9k GitHub starsSkillBacklink Comparison ToolRyze-AI-Adgent/open-seo-mcp-skills · by Ryze-AI-AdgentBacklink profile for any domain — referring domains, authority, anchors, new/lost links, and a side-by-side vs a competitor. Use when asked "check my backlinks", "backlink profile of X", "who links to them", or "link gap vs competitor".★ 3.1k GitHub starsSkillWeb Vitals Auditoraddyosmani/web-quality-skills · by addyosmaniOptimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".★ 2.8k GitHub starsSkillSEO Publishing Looptsingyuai/growth-lab · by tsingyuaiRun an SEO page observation-action-review loop with persistent Memory by coordinating demand research, page creation, adversarial review, image generation, IndexNow submission, and performance review. Use when taking an SEO page from opportunity discovery through publication, measurement, iteration, or continuing a previous SEO loop from Memory.★ 2k GitHub stars

More from AgriciDaniel

SkillAgent Browsing AuditorAgriciDaniel/claude-seo · by AgriciDanielAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).★ 17.4k GitHub starsSkillAI Search OptimizationAgriciDaniel/claude-seo · by AgriciDanielOptimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences. Generative Engine Optimization (GEO) analysis including brand mention signals, AI crawler accessibility, llms.txt compliance, passage-level citability scoring, and platform-specific optimization. Use when user says "AI Overviews", "SGE", GEO", "AI search", "LLM optimization", "Perplexity", "AI citations", ChatGPT search", or "AI visibility".★ 17.4k GitHub starsSkillBacklink Profile AnalysisAgriciDaniel/claude-seo · by AgriciDanielBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.★ 17.4k GitHub starsSkillAmazon Ads AuditorAgriciDaniel/claude-ads · by AgriciDanielYou share your Amazon advertising numbers and goals; you get back a plain-language review of what's draining your budget and what to change first.★ 9.5k GitHub starsSkillApple Search Ads AuditorAgriciDaniel/claude-ads · by AgriciDanielPaste what you're spending on Apple Search Ads and your recent numbers; get back a plain review of what's wasting money and what to fix first.★ 9.5k GitHub starsSkillAttribution AuditorAgriciDaniel/claude-ads · by AgriciDanielPaste the sales and spend numbers each ad platform claims, and get back a plain explanation of why they disagree and which figure to trust.★ 9.5k GitHub stars

Browse more free Claude skills or everything in Marketing.