HOME SKILLS BLOG GITHUB
// SKILL

FLOW FRAMEWORK
EVIDENCE-LED SEO

FLOW is an evidence-led SEO prompt framework organized across five stages: Find, Leverage, Optimize, Win, and Local. It gives Claude SEO 41 structured prompts with explicit evidence requirements, so each analysis starts from a defined search problem and produces an actionable output. FLOW is bundled under CC BY 4.0.

By Daniel Agrici · Last updated:

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

How does the FLOW framework work?

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.

Primary references: Google's people-first content guidance provides the quality questions used in evidence-led review, and the official Creative Commons Attribution 4.0 deed states the terms under which FLOW can be shared and adapted.

/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 do you run a FLOW analysis?

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

What should you know 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.
// RELATED SKILLS

EXPLORE MORE

VIEW ALL 25 SKILLS →

RUN YOUR FIRST FLOW LOOP
WITH EVIDENCE.

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