seo-flow
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.
- License 许可
- MIT
- 最近更新
- 2026-10-15
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- seo-flow
- license
- MIT
- metadata
- { "author": "AgriciDaniel", "version": "2.2.4", "category": "seo" }
- 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.
- argument-hint
- [stage] [url|topic]
- user-invocable
- true
02 资源文件 45
- 参考文档references/bibliography.md7.9 KB
- 参考文档references/flow-framework.md4.8 KB
- 参考文档references/flow-prompts.lock6.0 KB
- 参考文档references/prompts/find/content-planning-for-topical-relevance-prompt.md2.1 KB
- 参考文档references/prompts/find/content-prioritization-prompt.md2.1 KB
- 参考文档references/prompts/find/keyword-research-prompt.md2.1 KB
- 参考文档references/prompts/find/keyword-variations-for-topical-relevance-prompt.md2.1 KB
- 参考文档references/prompts/find/prompt-audience-avatar.md2.1 KB
- 参考文档references/prompts/leverage/backlink-competition-prompt.md2.1 KB
- 参考文档references/prompts/local/ai-homepage-rewrite-prompt.md2.1 KB
- 参考文档references/prompts/local/claude-deep-research-prompt.md2.1 KB
- 参考文档references/prompts/local/gbp-categories-prompt.md2.1 KB
- 参考文档references/prompts/local/gbp-description-claude-prompt-1.md2.1 KB
- 参考文档references/prompts/local/gbp-description-claude-prompt-2.md2.1 KB
- 参考文档references/prompts/local/gbp-description-claude-prompt-3.md2.1 KB
- 参考文档references/prompts/local/gbp-services-prompt.md2.0 KB
- 参考文档references/prompts/local/prompt-generating-a-meta-description.md2.1 KB
- 参考文档references/prompts/local/prompt-generating-a-title-tag.md2.1 KB
- 参考文档references/prompts/local/prompt-rewriting-existing-homepage.md2.1 KB
- 参考文档references/prompts/local/prompt-rewriting-existing-service-page.md2.1 KB
- 参考文档references/prompts/optimize/ai-detector-test-follow-up-prompt.md2.1 KB
- 参考文档references/prompts/optimize/ai-supporting-pages-rewrite-prompt.md2.1 KB
- 参考文档references/prompts/optimize/basic-prompt.md2.0 KB
- 参考文档references/prompts/optimize/blog-post-outline-prompt.md2.1 KB
- 参考文档references/prompts/optimize/blog-post-writing-prompt.md2.1 KB
- 参考文档references/prompts/optimize/claude-prompt-1.md2.0 KB
- 参考文档references/prompts/optimize/claude-prompt-2.md2.0 KB
- 参考文档references/prompts/optimize/ctr-audit-prompt.md2.0 KB
- 参考文档references/prompts/optimize/follow-up-prompt-1.md2.1 KB
- 参考文档references/prompts/optimize/follow-up-prompt-2.md2.1 KB
- 参考文档references/prompts/optimize/follow-up-prompt.md2.0 KB
- 参考文档references/prompts/optimize/paa-question-rewording-prompt.md2.1 KB
- 参考文档references/prompts/optimize/prompt-core-30-content-audit.md2.1 KB
- 参考文档references/prompts/optimize/property-content-with-authority-audit-prompt.md2.1 KB
- 参考文档references/prompts/optimize/reddit-claude-prompt.md2.1 KB
- 参考文档references/prompts/optimize/schema-prompt-1.md2.0 KB
- 参考文档references/prompts/optimize/step-1-the-chatgpt-discovery-prompt.md2.1 KB
- 参考文档references/prompts/optimize/step-2-the-follow-up-qualifying-prompt.md2.1 KB
- 参考文档references/prompts/optimize/technical-audit-prompt.md2.1 KB
- 参考文档references/prompts/optimize/visibility-follow-up-prompt.md2.1 KB
- 参考文档references/prompts/optimize/visiblity-prompt.md2.0 KB
- 参考文档references/prompts/README.md4.4 KB
- 参考文档references/prompts/win/bofu-page-brief-generator.md2.2 KB
- 参考文档references/prompts/win/conversion-audit-prompt.md2.2 KB
- 参考文档references/prompts/win/dual-surface-content-scorecard.md2.1 KB
03 SKILL.md 正文
FLOW Framework: Find · Leverage · Optimize · Win
FLOW is an evidence-led SEO operating model built for the AI-search era. Codex 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.
Framework and prompts © Daniel Agrici, CC BY 4.0: github.com/AgriciDaniel/flow
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)
- Read
references/flow-framework.md - Show the FLOW stage overview with a one-line description of each stage
- Ask: which stage matches the user's current situation?
On /seo flow find [url|topic]
- Read all files in
references/prompts/find/ - Apply each prompt to the URL or topic
- Cross-reference: "For deeper SERP clustering, see
/seo cluster <seed-keyword>"
On /seo flow leverage [url]
- Read the file in
references/prompts/leverage/ - Apply to the URL's current backlink context
- Cross-reference: "For raw backlink data, see
/seo backlinks <url>"
On /seo flow optimize [url]
- Read all file names in
references/prompts/optimize/ - Read prior analysis context (URL, industry vertical, any prior skill output in conversation)
- Select 2-3 most relevant prompts; load only those files
- Apply selected prompts; note the others are accessible via
/seo flow prompts - Cross-reference: "For full content quality analysis, see
/seo content <url>and/seo geo <url>"
On /seo flow win [url]
- Read all files in
references/prompts/win/ - Apply each prompt to the URL's conversion and BOFU context
- Cross-reference: "For SXO persona scoring, see
/seo sxo <url>"
On /seo flow local [url]
- Read all files in
references/prompts/local/ - Apply to the URL's local SEO context
- Cross-reference: "For full local SEO analysis, see
/seo local <url>and/seo maps [command]"
On /seo flow prompts
- Read
references/prompts/README.md - Display the full index: all 41 prompts with stage, name, trigger conditions
On /seo flow sync
- Run:
"$HOME/.Codex/skills/seo/bin/Codex-seo" run sync_flow.py - Display the JSON summary (files added, updated, unchanged)
- Show attribution notice after sync completes
Context Matching (Optimize stage)
The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:
- Industry vertical (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness)
- Prior skill output (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts)
- 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 flowactivation)references/bibliography.md: Evidence sources; load when citing studies or statisticsreferences/prompts/README.md: Prompt index; load for/seo flow promptsreferences/prompts/find/: 5 prompts; load for/seo flow findreferences/prompts/leverage/: 1 prompt; load for/seo flow leveragereferences/prompts/optimize/: 21 prompts; load selectively for/seo flow optimizereferences/prompts/win/: 3 prompts; load for/seo flow winreferences/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. |
04 同仓库更多 Skills
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
seo-audit
Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to up to 15 specialists (8 always + 7 conditional), generates health score. Use when user says audit, full SEO check, analyze my site, or website health check.
playwright
Use when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via `playwright-cli` or the bundled wrapper script.
gsap-performance
Official GSAP skill for performance — prefer transforms, avoid layout thrashing, will-change, batching. Use when optimizing GSAP animations, reducing jank, or when the user asks about animation performance, FPS, or smooth 60fps.
firecrawl-seo-audit
Audit a website's SEO with Firecrawl. Use when the user asks for an SEO audit, metadata and heading review, sitemap/site-structure analysis, keyword opportunities, competitor SERP comparison, or prioritized search optimization recommendations.
firecrawl-qa
QA test a live website with Firecrawl browser and scrape evidence. Use when the user wants exploratory QA, form testing, navigation/link checks, responsive checks, performance observations, bug reports, or a pre-launch quality review.