Skip to content

build-with-dhiraj/ai-workflow-framework-portability-kit / Plugins/claude-seo-source/skills/seo-flow

seo-flow

Verified

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.

FileKindSize
SKILL.mdskill md5.5 KB
references/bibliography.mdmarkdown7.9 KB
references/flow-framework.mdmarkdown4.8 KB
references/flow-prompts.lockother6.0 KB
references/prompts/README.mdmarkdown4.4 KB
references/prompts/find/content-planning-for-topical-relevance-prompt.mdmarkdown2.1 KB
references/prompts/find/content-prioritization-prompt.mdmarkdown2.1 KB
references/prompts/find/keyword-research-prompt.mdmarkdown2.1 KB
references/prompts/find/keyword-variations-for-topical-relevance-prompt.mdmarkdown2.2 KB
references/prompts/find/prompt-audience-avatar.mdmarkdown2.1 KB
references/prompts/leverage/backlink-competition-prompt.mdmarkdown2.1 KB
references/prompts/local/ai-homepage-rewrite-prompt.mdmarkdown2.1 KB
references/prompts/local/claude-deep-research-prompt.mdmarkdown2.1 KB
references/prompts/local/gbp-categories-prompt.mdmarkdown2.1 KB
references/prompts/local/gbp-description-claude-prompt-1.mdmarkdown2.1 KB
references/prompts/local/gbp-description-claude-prompt-2.mdmarkdown2.1 KB
references/prompts/local/gbp-description-claude-prompt-3.mdmarkdown2.1 KB
references/prompts/local/gbp-services-prompt.mdmarkdown2.1 KB
references/prompts/local/prompt-generating-a-meta-description.mdmarkdown2.1 KB
references/prompts/local/prompt-generating-a-title-tag.mdmarkdown2.1 KB
references/prompts/local/prompt-rewriting-existing-homepage.mdmarkdown2.1 KB
references/prompts/local/prompt-rewriting-existing-service-page.mdmarkdown2.1 KB
references/prompts/optimize/ai-detector-test-follow-up-prompt.mdmarkdown2.1 KB
references/prompts/optimize/ai-supporting-pages-rewrite-prompt.mdmarkdown2.1 KB
references/prompts/optimize/basic-prompt.mdmarkdown2.1 KB
references/prompts/optimize/blog-post-outline-prompt.mdmarkdown2.1 KB
references/prompts/optimize/blog-post-writing-prompt.mdmarkdown2.1 KB
references/prompts/optimize/claude-prompt-1.mdmarkdown2.1 KB
references/prompts/optimize/claude-prompt-2.mdmarkdown2.1 KB
references/prompts/optimize/ctr-audit-prompt.mdmarkdown2.1 KB
references/prompts/optimize/follow-up-prompt-1.mdmarkdown2.1 KB
references/prompts/optimize/follow-up-prompt-2.mdmarkdown2.1 KB
references/prompts/optimize/follow-up-prompt.mdmarkdown2.1 KB
references/prompts/optimize/paa-question-rewording-prompt.mdmarkdown2.1 KB
references/prompts/optimize/prompt-core-30-content-audit.mdmarkdown2.1 KB
references/prompts/optimize/property-content-with-authority-audit-prompt.mdmarkdown2.2 KB
references/prompts/optimize/reddit-claude-prompt.mdmarkdown2.1 KB
references/prompts/optimize/schema-prompt-1.mdmarkdown2.1 KB
references/prompts/optimize/step-1-the-chatgpt-discovery-prompt.mdmarkdown2.1 KB
references/prompts/optimize/step-2-the-follow-up-qualifying-prompt.mdmarkdown2.1 KB
references/prompts/optimize/technical-audit-prompt.mdmarkdown2.1 KB
references/prompts/optimize/visibility-follow-up-prompt.mdmarkdown2.1 KB
references/prompts/optimize/visiblity-prompt.mdmarkdown2.1 KB
references/prompts/win/bofu-page-brief-generator.mdmarkdown2.3 KB
references/prompts/win/conversion-audit-prompt.mdmarkdown2.2 KB
references/prompts/win/dual-surface-content-scorecard.mdmarkdown2.2 KB
---
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-invokable: true
argument-hint: "[stage] [url|topic]"
license: MIT
metadata:
  author: AgriciDaniel
  version: "1.9.9"
  category: seo
---

# FLOW Framework — Find · Leverage · Optimize · Win

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

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.

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

| Command | What it does |
|---------|-------------|
| `/seo flow` | Show 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 prompts` | Full index of all 41 prompts — stage, name, trigger conditions |
| `/seo flow sync` | Pull 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]`"

### 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: `python scripts/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

| Scenario | Action |
|----------|--------|
| `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 error | Display the script's stderr. Check rate limits: `gh api rate_limit`. |
| `sync_flow.py` auth error | Run `gh auth login` then retry. |
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall