HOME SKILLS BLOG GITHUB
// SKILL

FLOW FRAMEWORK
EVIDENCE-LED SEO

Stop running improvised SEO queries against AI. FLOW gives Claude SEO 41 evidence-led prompts organized across five stages: Find, Leverage, Optimize, Win, and Local. Every analysis is anchored in a structured prompt with stated evidence, not vibes. Bundled under CC BY 4.0. Free with Claude SEO.

FRAMEWORK © DANIEL AGRICI · CC BY 4.0 · github.com/AgriciDaniel/flow
$
/seo flow [stage] https://your-site.com

REQUIRES CLAUDE SEO INSTALLED IN CLAUDE CODE

Claude SEO FLOW framework with Find Leverage Optimize Win and Local stages
// HOW IT WORKS

5 STAGES. 41 PROMPTS.

FLOW (Find, Leverage, Optimize, Win) is an operating model for the AI-search era. Each stage maps to a different SEO problem and ships with structured prompts that Claude SEO surfaces on demand. A fifth Local track handles GBP, NAP, and map-pack work.

Instead of guessing how to query an LLM about your SEO, you pick the stage you are in and FLOW selects the right prompts. The Optimize stage uses context-matching orchestration: with 21 prompts available, Claude SEO loads only the 2-3 most relevant based on your industry, URL signals, and any prior skill output already in your conversation.

/seo flow [stage] <url> FIND 5 prompts keyword + intent LEVERAGE 1 prompt off-site authority OPTIMIZE 21 prompts context-matched WIN 3 prompts BOFU + CRO LOCAL 11 prompts GBP + map pack EVIDENCE-TAGGED FINDINGS Cross-references: /seo cluster, /seo backlinks, /seo content, /seo geo, /seo local

The Five Stages

Each stage answers a different question. You rarely run all five in one session. Pick the stage that matches your current bottleneck.

F
FIND
Keyword research, SERP intent mapping, gap analysis. 5 prompts. Use when starting on a new topic or domain and you do not yet know what to target.
L
LEVERAGE
Off-site authority strategy. 1 prompt. Use to design a backlink and partnership plan grounded in your current authority profile.
O
OPTIMIZE
21 prompts covering on-page, technical, content quality, freshness, and structured data. Claude SEO selects the 2-3 most relevant per analysis, never dumps all 21.
W
WIN
Bottom-of-funnel and conversion. 3 prompts. Use on product, pricing, and money pages to convert organic traffic into pipeline and revenue.
+
LOCAL
11 prompts for GBP optimization, NAP consistency, location-page tuning, and map-pack visibility. Activates automatically when local signals detected.
Σ
CONTEXT-MATCHED
The Optimize stage never dumps all 21 prompts. It selects the 2-3 most relevant based on industry, URL signals, and prior skill output already in the conversation. Surface area without noise.
// USAGE

HOW TO RUN FLOW

Stage Commands

CommandWhat it does
/seo flowShows the stage menu with one-line descriptions
/seo flow find [url|topic]Runs all 5 Find prompts
/seo flow leverage [url]Runs the Leverage prompt against current backlink context
/seo flow optimize [url]Selects and runs 2-3 of 21 Optimize prompts by context
/seo flow win [url]Runs all 3 Win prompts for BOFU and conversion
/seo flow local [url]Runs all 11 Local prompts
/seo flow promptsLists every prompt with stage, name, and trigger
/seo flow syncPulls the latest prompts from github.com/AgriciDaniel/flow

Cross-Skill References

FLOW does not duplicate the rest of Claude SEO. It points to the right specialist skill when one is needed:

Syncing the Prompt Library

FLOW prompts live in the upstream repo at github.com/AgriciDaniel/flow. Run /seo flow sync to pull the latest version. The sync script is anonymous-first against the GitHub API (no token required for under 60 requests per hour on public repos). A SHA-256 lockfile (flow-prompts.lock) tracks baseline integrity and reports upstream drift before writing. File writes are atomic, capped at 5 MB, with a 15-second timeout and a strict allowlist for api.github.com over HTTPS.

Attribution

Every /seo flow activation outputs this header before analysis:

Framework and prompts © Daniel Agrici, CC BY 4.0, github.com/AgriciDaniel/flow

The attribution is required by the CC BY 4.0 license and is automated by the sync script. Do not remove it.

// FAQ

QUESTIONS ABOUT FLOW

FLOW is an evidence-led SEO operating model built for the AI-search era. It organizes SEO work into five stages: Find (keyword and SERP intent research), Leverage (off-site authority and backlinks), Optimize (on-page and technical), Win (BOFU and conversion), and Local (GBP and local search). Each stage ships with structured AI prompts that drive analysis based on evidence rather than improvised queries.
41 prompts in total: 5 Find prompts, 1 Leverage prompt, 21 Optimize prompts, 3 Win prompts, and 11 Local prompts. The Optimize stage uses context-matching orchestration: instead of dumping all 21 prompts, Claude SEO selects 2-3 most relevant based on industry vertical, URL signals, and any prior skill output in the conversation.
Yes. The FLOW prompts are released under CC BY 4.0 by Daniel Agrici and bundled inside Claude SEO with attribution. Claude SEO's skill code remains MIT-licensed. You can use, modify, and redistribute the prompts as long as attribution to the FLOW repo (github.com/AgriciDaniel/flow) is preserved.
FLOW cross-references the rest of the skill catalog. A Find-stage run will suggest /seo cluster for SERP clustering. A Leverage-stage run will suggest /seo backlinks for raw backlink data. An Optimize-stage run will suggest /seo content and /seo geo for deeper content quality and AI-search analysis. The framework sits on top of the existing skills rather than replacing them.
Run /seo flow sync. The command calls scripts/sync_flow.py which uses the anonymous-first GitHub API to pull the latest prompt files from github.com/AgriciDaniel/flow. A SHA-256 lockfile (flow-prompts.lock) tracks baseline integrity, and the sync reports upstream drift before writing. No GitHub token is required for public repos under 60 requests per hour.
// RELATED SKILLS

EXPLORE MORE

VIEW ALL 23 SKILLS →

RUN YOUR FIRST FLOW LOOP
IN 30 SECONDS.

$
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git && bash claude-seo/install.sh
VIEW ON GITHUB ALL SKILLS >