Agent skill

FLOW SEO Framework

by AgriciDaniel in AgriciDaniel/claude-seo

Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

MITAuto-check passedMarketing & SEO

Install FLOW SEO Framework

skills CLI
$ npx skills add AgriciDaniel/claude-seo --skill seo-flow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-seo seo-flow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-flow .claude/skills/seo-flow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-flow
GitHub stars
19k
Used in
2 other repos
Token cost
~1.4k tokens
SKILL.md length
658 words
Files
48 (incl. references)
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

  • Works in 3 steps: Read references/flow-framework.md → Show the FLOW stage overview with a… → Ask: which stage matches the user's…
  • Running keyword research and gap analysis with structured prompts
  • SKILL.md covers Commands, Orchestration Logic, Context Matching (Optimize… and Reference Files, plus 2 more sections
  • Calls gh

What it does

FLOW is an evidence-led SEO model that runs from Find through an off-site authority stage and an Optimize stage to Win. The skill carries a library of 41 prompts across five stages and surfaces only those for the stage you ask about, loading the framework reference on every activation and prompt files on demand. The prompts are credited to Daniel Agrici under CC BY 4.0.

Everything runs through /seo flow commands: an overview with a stage menu; find for keyword research, gap analysis and SERP intent mapping (5 prompts); the off-site command for backlink strategy (1 prompt); optimize, which picks the 2 to 3 most relevant of 21 prompts for the context; win for bottom-of-funnel work, conversion rate and a dual-surface scorecard (3 prompts); local for Google Business Profile, meta and title tags and local audits (11 prompts); a full prompt index; and a sync that pulls the latest prompts from GitHub. Each stage points to deeper skills for clustering, backlinks, content and GEO analysis.

When your agent uses it

  • Running keyword research and gap analysis with structured prompts
  • Planning a backlink strategy for a site
  • Picking on-page optimization prompts for a given URL
  • Improving conversion pages and bottom-of-funnel content
  • Optimizing a Google Business Profile and local SEO

Example prompts

  • “Run the FLOW find stage for the topic standing desks.”
  • “Which FLOW optimize prompts fit https://example.com/pricing? Pick the two or three most relevant.”
  • “Use the FLOW local prompts to review our Google Business Profile categories and description.”

Requirements

  • The Claude SEO skill suite, which provides the /seo commands

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  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?

What it can do on your machine

Read from SKILL.md and the folder at commit 4b99de2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

FLOW SEO Framework loads about 1.4k tokens when it runs, and up to ~29k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 658 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~29k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-seo at commit 4b99de2, republished under its MIT licence (© AgriciDaniel). 658 words, ~1,408 tokens.

Download SKILL.mdSave it as .claude/skills/seo-flow/SKILL.md (or your agent's skills folder). This skill also uses 47 other files; get the full folder from GitHub.
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
metadata.version
2.4.2
metadata.category
seo

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]"
Show full SKILL.md (262 more words)Show less
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

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.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 47 other files (references) in skills/seo-flow of AgriciDaniel/claude-seo.

  • SKILL.md
  • references/bibliography.md
  • references/flow-framework.md
  • references/flow-prompts.lock
  • references/prompts/README.md
  • references/prompts/find/content-planning-for-topical-relevance-prompt.md
  • references/prompts/find/content-prioritization-prompt.md
  • references/prompts/find/keyword-research-prompt.md
  • references/prompts/find/keyword-variations-for-topical-relevance-prompt.md
  • references/prompts/find/prompt-audience-avatar.md
  • references/prompts/leverage/backlink-competition-prompt.md
  • references/prompts/local/ai-homepage-rewrite-prompt.md
  • references/prompts/local/claude-deep-research-prompt.md
  • references/prompts/local/gbp-categories-prompt.md
  • references/prompts/local/gbp-description-claude-prompt-1.md
  • references/prompts/local/gbp-description-claude-prompt-2.md
  • … and 32 more

Open the folder on GitHubat commit 4b99de2

Used in 4 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AgriciDaniel/claude-seo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

FLOW SEO Framework next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

FLOW SEO Framework compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
FLOW SEO Framework this skillAgriciDaniel/claude-seo19k2 repos~1.4kAutomated safety check: PassMIT
DataForSEO SEO Toolkitzubair-trabzada/dataforseo-claude164—~3.2kAutomated safety check: NotesMIT
Global SEO Growthminhnv0807/ai-business-skills610—~5kAutomated safety check: PassMIT
Page Play Builderaaron-he-zhu/aaron-marketing-skills2.9k—~3.6kAutomated safety check: PassApache-2.0
SEONexus-JPF/note-companion870—~2.2kAutomated safety check: PassMIT
SEO Competitorrampstackco/claude-skills941—~1.8kAutomated safety check: PassMIT

Similar skills

  • DataForSEO SEO Toolkit

    zubair-trabzada/dataforseo-claude

    Runs keyword research, rank checks, backlink and competitor analysis, site audits and PDF reports from live Google data through the DataForSEO API.

    164 GitHub stars~3.2k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check: notes
  • Global SEO Growth

    minhnv0807/ai-business-skills

    Covers six SEO layers for a website: crawl and index audit, local SEO, search-intent content, AI search visibility, schema markup and backlink or directory distribution.

    610 GitHub stars~5k tokensUpdated 27 days ago
    Marketing & SEOAuto-check passed
  • Page Play Builder

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "build programmatic SEO pages", "generate pages at scale", "rank on a high-authority third-party site", "borrow domain authority", "build a vs /…

    2.9k GitHub stars~3.6k tokensUpdated today
    Marketing & SEOAuto-check passed
  • SEO

    Nexus-JPF/note-companion

    Use and read this skill immediately if the user request is in any way related to SEO or a site's organic search or AI search presence.

    870 GitHub stars~2.2k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • SEO Competitor

    rampstackco/claude-skills

    Run a competitive SEO analysis comparing the user's site to chosen competitors across SERP overlap, content depth, backlink profiles, technical posture, and brand presence.

    941 GitHub stars~1.8k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • SEO Plan

    indranilbanerjee/digital-marketing-pro

    Build a 12-month SEO strategy and phased roadmap with industry templates (SaaS, ecommerce, local, publisher, agency).

    859 GitHub starsUsed in 1 repo~3.9k tokens
    Marketing & SEOAuto-check passed

More from AgriciDaniel/claude-seo

All 33 skills in this repo
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Auto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Auto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    19k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • SEO Drift Monitor

    AgriciDaniel/claude-seo

    Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.

    19k GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed

Categories

Questions about FLOW SEO Framework

What does FLOW SEO Framework do?

Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand. FLOW is an evidence-led SEO model that runs from Find through an off-site authority stage and an Optimize stage to Win. The skill carries a library of 41 prompts across five stages and surfaces only those for the stage you ask about, loading the framework reference on every activation and prompt files on demand.

When should I use FLOW SEO Framework?

FLOW SEO Framework fits situations like: running keyword research and gap analysis with structured prompts; planning a backlink strategy for a site; picking on-page optimization prompts for a given URL; improving conversion pages and bottom-of-funnel content.

How do I install FLOW SEO Framework in Claude Code?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-flow -a claude-code`. Or copy the skill folder (skills/seo-flow in AgriciDaniel/claude-seo) into .claude/skills/seo-flow in your project. Claude Code loads it when a task matches its description.

How do I install FLOW SEO Framework in Codex?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-flow -a codex`. Or copy the skill folder (skills/seo-flow in AgriciDaniel/claude-seo) into .agents/skills/seo-flow in your project. Codex loads it when a task matches its description.

Can I use FLOW SEO Framework in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-seo --skill seo-flow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-flow, .gemini/skills/seo-flow, .github/skills/seo-flow and .opencode/skills/seo-flow in your project.

What does FLOW SEO Framework need to run?

Going by SKILL.md and its folder, FLOW SEO Framework needs the command-line tools its instructions call (gh). Our summary lists: The Claude SEO skill suite, which provides the /seo commands.

Does FLOW SEO Framework access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is FLOW SEO Framework safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does FLOW SEO Framework use?

FLOW SEO Framework is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does FLOW SEO Framework use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 28k tokens, read only when the agent opens those files.

What are the alternatives to FLOW SEO Framework?

Skills that share tags, products or a category with FLOW SEO Framework: DataForSEO SEO Toolkit (zubair-trabzada/dataforseo-claude, 164 stars), Global SEO Growth (minhnv0807/ai-business-skills, 610 stars), Page Play Builder (aaron-he-zhu/aaron-marketing-skills, 2.9k stars) and SEO (Nexus-JPF/note-companion, 870 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains FLOW SEO Framework?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,574 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 4, 2026.

Source: AgriciDaniel/claude-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.