mcpField
S
seo-flow

seo-flow

github.com/infrasity-labsMarketing & growth15088 installsUpdated 18w ago
Repository

About seo-flow

An evidence-led SEO workflow skill that organizes analysis into FLOW stages: Find, Leverage, Optimize, Win, and Local. It provides 41 structured prompts and selects relevant optimization prompts based on context.

Key features

  1. 01Run five SEO analysis stages
  2. 02Use 41 stage-based prompts
  3. 03Select optimization prompts by context
  4. 04Sync prompts from the FLOW repository

Use cases

  1. 01Research keywords and search intent
  2. 02Plan backlink and authority work
  3. 03Choose focused on-page optimization checks
  4. 04Review local SEO and conversion opportunities

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill seo-flow

After installing, type/seo-flowin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
bibliography.md
flow-framework.md
flow-prompts.lock
references/prompts/find/
content-planning-for-topical-relevance-prompt.md
content-prioritization-prompt.md
keyword-research-prompt.md
keyword-variations-for-topical-relevance-prompt.md
prompt-audience-avatar.md
references/prompts/leverage/
backlink-competition-prompt.md
references/prompts/local/
ai-homepage-rewrite-prompt.md
claude-deep-research-prompt.md
gbp-categories-prompt.md
gbp-description-claude-prompt-1.md
gbp-description-claude-prompt-2.md
gbp-description-claude-prompt-3.md
gbp-services-prompt.md
prompt-generating-a-meta-description.md
prompt-generating-a-title-tag.md
prompt-rewriting-existing-homepage.md
prompt-rewriting-existing-service-page.md
references/prompts/optimize/
ai-detector-test-follow-up-prompt.md
ai-supporting-pages-rewrite-prompt.md
basic-prompt.md
blog-post-outline-prompt.md
blog-post-writing-prompt.md
claude-prompt-1.md
claude-prompt-2.md
ctr-audit-prompt.md
follow-up-prompt-1.md
follow-up-prompt-2.md

Details

From the project README

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.

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]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 promptsFull index of all 41 prompts — stage, name, trigger conditions
/seo flow syncPull latest prompt files from the FLOW prompt repository

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_seo.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:

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

Comments

Markdown supported