# seo-flow

> FLOW framework integration providing evidence-led SEO using the Find, Leverage, Optimize, and Win loop, with 41 stage-specific AI prompts across five stages including a dedicated Local stage with 11 prompts.

**Use case**: Run structured evidence-led SEO prompts at every stage

**Canonical URL**: https://agentcookbooks.com/skills/seo-flow/

**Topics**: claude-code, skills, marketing, seo

**Trigger phrases**: "FLOW framework", "seo flow", "evidence-led SEO", "find leverage optimize win", "FLOW prompts"

**Source**: [AgriciDaniel](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo-flow)

**License**: MIT

---

## What it does

`seo-flow` is a Claude Code skill from AgriciDaniel's [claude-seo repo](https://github.com/AgriciDaniel/claude-seo). It integrates the FLOW prompt library (41 prompts, CC BY 4.0) into the claude-seo skill ecosystem. FLOW is an evidence-led SEO operating model built for the AI-search era: Find (5 prompts for keyword research, gap analysis, SERP intent mapping), Leverage (1 prompt for backlink strategy), Optimize (21 prompts for on-page, content, and technical improvements — selectively loaded by context), Win (3 prompts for BOFU, conversion rate, dual-surface scoring), and Local (11 prompts for GBP optimization, meta, title tags, structured local audits).

The key design decision is that the Optimize stage surfaces exactly 2–3 of its 21 prompts rather than dumping all of them. Selection is based on industry vertical, prior skill output in the conversation, and URL signals. The skill names which prompts it chose and why before applying them.

## When to use it

Reach for it when:

- You want structured prompts rather than improvised queries to drive an SEO analysis
- You are at a specific stage in an SEO engagement (finding keywords, optimizing content, improving local signals) and want the stage-appropriate prompt set
- You are doing local SEO and want the full 11-prompt local audit workflow

When *not* to reach for it:

- The reference files have not been synced from the FLOW repo yet — run `/seo flow sync` first; without the prompt files the skill has nothing to apply
- You need raw data (keyword volume, backlink counts) — FLOW prompts guide analysis, they do not fetch live data

## Install

Copy the [`seo-flow` SKILL.md](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo-flow) into `.claude/skills/seo-flow/` and run `/seo flow sync` to pull the prompt library from `github.com/AgriciDaniel/flow`.

Trigger phrases: "FLOW", "FLOW framework", "seo flow", "evidence-led SEO", "find leverage optimize win".

Every activation of any `/seo flow` command prepends the attribution notice: "Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow".

## What a session looks like

A typical session has three phases:

1. **Stage selection.** `/seo flow` with no sub-command shows the five-stage overview and asks which stage matches your current situation — it is a diagnostic before diving into prompts.
2. **Prompt application.** The relevant prompt files are loaded on demand (not at startup). For the Optimize stage, 2–3 prompts are selected from 21 based on context: a SaaS site with a prior `seo-technical` flag gets technical optimize prompts; a local service site with E-E-A-T gaps gets content optimize prompts.
3. **Cross-skill handoff.** Each stage names the complementary claude-seo skill to use for deeper data: Find stage cross-references `/seo cluster`, Optimize stage cross-references `/seo content` and `/seo geo`, Win stage cross-references `/seo sxo`, Local stage cross-references `/seo local` and `/seo maps`.

## Receipts

**Works well:** The context-aware Optimize stage selection is the most useful feature — having 21 prompts loaded and applied would be overwhelming; having 2–3 selected based on what the prior audit found in the conversation is actually useful.

**Backfires:** If the prompt files are not synced, every command fails gracefully with "Run `/seo flow sync`" — but this means the skill is entirely non-functional until you run that initial sync. It is not the kind of skill that degrades gracefully when files are missing.

**Pattern that works:** Run `/seo flow find` before building a content cluster, `/seo flow optimize` after a technical audit, and `/seo flow win` before writing a landing page. Each stage takes about 10 minutes and produces structured evidence you can use to justify specific optimizations.

## Source and attribution

Originally written by [AgriciDaniel](https://github.com/AgriciDaniel). FLOW framework and prompts are CC BY 4.0, authored by Daniel Agrici at [github.com/AgriciDaniel/flow](https://github.com/AgriciDaniel/flow). The canonical SKILL.md lives in the [`seo-flow` folder](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo-flow) of the [claude-seo repository](https://github.com/AgriciDaniel/claude-seo).

License: MIT (skill wrapper). FLOW prompts: CC BY 4.0. Attribution required when redistributing prompt content.

This page documents the skill from a practitioner's perspective. For the formal spec and updates, defer to the source repo.