New to Claude Skills? Learn how to install them →

Get Claude Skills
agricidaniel on GitHub

SEO Flow

Free

Streamline your SEO with evidence-backed AI prompts.

by agricidaniel13.9k stars on agricidaniel/claude-seo
2 views
Updated Jul 20, 2026
Get this skill

Free · Opens the source repo

What SEO Flow does

SEO Flow is an integrated skill designed to enhance your SEO strategy using the FLOW framework, which emphasizes an evidence-led approach to search engine optimization. It provides a structured process for SEO analysis through a series of stage-specific prompts, allowing users to systematically find, leverage, optimize, and win in their SEO efforts. By utilizing 41 prompts across five distinct stages, SEO Flow ensures that each analysis is grounded in data and best practices rather than guesswork.

The FLOW framework operates through four main stages: Find, Leverage, Optimize, and Win. Each stage is equipped with tailored prompts that guide users through essential SEO tasks such as keyword research, backlink strategies, content optimization, and conversion rate analysis. For instance, the Find stage focuses on identifying relevant keywords and mapping SERP intent, while the Optimize stage helps prioritize content improvements based on industry-specific signals. This systematic approach not only improves the effectiveness of your SEO efforts but also saves time by providing targeted insights.

SEO Flow is particularly beneficial for SEO professionals, digital marketers, and content creators who seek to enhance their website's visibility and performance in search engines. By leveraging the prompts, users can conduct thorough analyses that are informed by evidence and tailored to their specific context. The integration of the FLOW framework into your SEO workflow allows for a comprehensive understanding of your current standing and actionable steps to improve it.

In summary, SEO Flow is a powerful tool for anyone looking to elevate their SEO strategy through structured, evidence-based prompts. Whether you are just starting out or are an experienced SEO practitioner, this skill can provide the guidance and insights needed to navigate the complexities of modern SEO effectively.

When to use it

Use SEO Flow when you need a systematic approach to SEO that leverages AI-driven prompts for analysis and optimization.

When not to use it

This skill may not be suitable for users looking for a quick, one-size-fits-all SEO solution without the need for structured analysis.

What you can build with it

Keyword Research

Use the `/seo flow find [url|topic]` command to conduct thorough keyword research and SERP intent mapping.

Backlink Strategy Development

Leverage the `/seo flow leverage [url]` command to create a robust backlink strategy based on your site's current authority.

Content Optimization

Optimize your content by running the `/seo flow optimize [url]` command to select the most relevant prompts for improvement.

How to install SEO Flow

View source

1. Install with the skills CLI

npx skills add agricidaniel/claude-seo/seo-flow --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by agricidaniel

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

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

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.

Frequently asked questions about SEO Flow

Similar skills

Guideline Generation

Transform brand materials into actionable voice guidelines.

Landing Page Conversion Audit

Identify and fix conversion leaks on landing pages.

0-to-1 Launch

Accelerate your product launch to find early customers.

Competitor Ad Intelligence

Analyze and reverse-engineer competitor ad strategies.

Content Strategy

Generate data-driven content plans for your business.

Webinar Marketing

Optimize your webinars for better engagement and conversion.