Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
agricidaniel avatar

Seo Flow

  • 22 installs
  • 548 repo stars
  • Updated July 20, 2026
  • agricidaniel/codex-seo

seo-flow is a Claude Code SEO skill that runs the FLOW (Find, Leverage, Optimize, Win) framework by surfacing 41 stage-specific AI SEO prompts.

About

seo-flow is a Claude Code skill that runs the FLOW (Find, Leverage, Optimize, Win) SEO operating model by surfacing a library of 41 stage-specific AI prompts. A developer uses it to get structured, evidence-led prompts for keyword research, backlink strategy, on-page optimization, conversion, and local SEO. It picks the most relevant prompts for the current context rather than improvising queries.

  • Integrates the FLOW framework's 41 AI SEO prompts across 5 stages (Find, Leverage, Optimize, Win, Local)
  • Selects the 2-3 most relevant prompts for the user's context instead of dumping all of them
  • Cross-references sibling skills like seo-cluster, seo-backlinks, seo-content, and seo-sxo

Seo Flow by the numbers

  • 22 all-time installs (skills.sh)
  • Ranked #1,468 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

seo-flow capabilities & compatibility

Free; syncing prompts uses the GitHub CLI (gh) and is subject to GitHub rate limits

Capabilities
keyword research · backlink strategy · on page optimization · conversion optimization · local seo · seo prompts
Works with
github
Use cases
seo · research · copywriting
Pricing
Free
From the docs

What seo-flow says it does

evidence-led SEO using the Find → Leverage → Optimize → Win loop.
SKILL.md
FLOW is an evidence-led SEO operating model built for the AI-search era.
SKILL.md
Always surface exactly 2-3 prompts. State which prompts you chose and why.
SKILL.md
npx skills add https://github.com/agricidaniel/codex-seo --skill seo-flow

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs22
repo stars548
Last updatedJuly 20, 2026
Repositoryagricidaniel/codex-seo

What it does

Run evidence-led SEO with stage-specific prompts for keyword research, backlinks, optimization, and conversion.

Who is it for?

Getting structured, stage-specific SEO prompts for keyword research, backlinks, on-page optimization, and conversion

Skip if: Running live API data pulls or crawling; it surfaces prompts rather than fetching metrics

When should I use this skill?

user says FLOW, FLOW framework, seo flow, evidence-led SEO, or find leverage optimize win

What you get

A curated, context-matched set of FLOW prompts applied to the user's URL or topic across the right SEO stage.

  • Stage-matched FLOW prompt applications
  • Prompt index across all 41 prompts

By the numbers

  • 41 prompts across 5 stages
  • 21 optimize-stage prompts
  • 11 local-stage prompts

Files

SKILL.mdMarkdownGitHub ↗

FLOW Framework — Find · Leverage · Optimize · Win

Shared Data Cache

Step 0 -- Check shared data cache:

Before gathering, check .seo-cache/ for reusable context from related SEO skills. Reference: ../seo/references/shared-data-cache.md for schemas and dependency map.

Check these cache files when present:

  • .seo-cache/site-meta.json for domain, business type, industry, and crawl context
  • .seo-cache/audit-scores.json for prior full-audit priorities
  • .seo-cache/pages/{url-slug}/page-analysis.json for page-level context when a URL is provided
  • If found: parse and use clearly valid fields (note "Using cached [X] from [date]")
  • If missing, corrupt, or irrelevant: continue with fresh evidence
  • If the user says "refresh" or "re-run": ignore cache reads and overwrite on write
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. Codex 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

CommandWhat it does
/seo flowShow FLOW overview + stage menu
`/seo flow find [url\topic]`
/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 promptsFull index of all 41 prompts — stage, name, trigger conditions
/seo flow syncPull 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: python scripts/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

ScenarioAction
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 errorDisplay the script's stderr. Check rate limits: gh api rate_limit.
sync_flow.py auth errorRun gh auth login then retry.

Write to shared data cache

After completing all work, write a concise JSON summary to .seo-cache/ when the workflow produced durable findings. Use the schemas and naming rules in ../seo/references/shared-data-cache.md; include at least cache_type, analyzed_at, source URL/domain, key findings, issues, recommendations, and tool limitations. Add .seo-cache/ to .gitignore if it is missing.

Related skills

FAQ

How many prompts does seo-flow include?

41 prompts across 5 stages: Find (5), Leverage (1), Optimize (21), Win (3), and Local (11).

Does it dump every prompt at once?

No. In the optimize stage it selects exactly 2-3 of the 21 prompts most relevant to your industry, prior skill output, and URL signals, and states why.

Marketing & SEOseocontent

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.