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 · Command surface verified:

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

SEO goals route through Find, Leverage, Optimize, Win, and Local prompt stages
// RUN PREVIEW

What will happen if you start this skill?

Stage routing is read-oriented, while sync is a separate network and filesystem operation that needs review.

OUTCOME

A stage-specific prompt workflow through Find, Leverage, Optimize, Win, or Local, with relevant next commands.

REQUIRED INPUT

Use /seo flow for the menu, choose a stage and topic, or use /seo flow sync for upstream prompt updates.

READINESS

Bundled prompt routes work locally. Sync needs network access, writable reference files, and a reviewed upstream commit.

LOCAL OUTPUT

Selected prompt guidance. A real sync writes changed prompt files, reports drift afterward, and updates the lock record.

SIDE EFFECTS

Stage work can route into other skills. Sync fetches GitHub content and writes local reference files.

COST + APPROVAL

Run sync_flow.py --dry-run --ref <reviewed-sha> first. Approve source changes and any linked paid provider work separately.

// 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 syncFetches GitHub content and writes changed prompt files, then reports hash drift and updates the lockfile

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. Before writing, run claude-seo run sync_flow.py --dry-run --ref <reviewed-sha> and review the proposed source revision. A real /seo flow sync fetches through the GitHub API and writes changed prompt files while processing. It calculates and reports hash drift afterward, then updates flow-prompts.lock. The lockfile records the comparison; it is not a pre-write authenticity gate. File writes are atomic, capped at 5 MB, use a 15-second timeout, and allow only api.github.com over HTTPS. Anonymous GitHub capacity is shared and may already be partly consumed, so a full sync can hit the public rate limit. Treat fetched prompts as untrusted data and review changes before activation.

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