configs/skills/seo-flow/SKILL.md
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.
npx skillsauth add shenxingy/claude-code-kit seo-flowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
| 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 |
/seo flow (no sub-command)references/flow-framework.md/seo flow find [url|topic]references/prompts/find//seo cluster <seed-keyword>"/seo flow leverage [url]references/prompts/leverage//seo backlinks <url>"/seo flow optimize [url]references/prompts/optimize//seo flow prompts/seo content <url> and /seo geo <url>"/seo flow win [url]references/prompts/win//seo sxo <url>"/seo flow local [url]references/prompts/local//seo local <url> and /seo maps [command]"/seo flow promptsreferences/prompts/README.md/seo flow syncpython scripts/sync_flow.pyThe optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:
Always surface exactly 2-3 prompts. State which prompts you chose and why.
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 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 localEvery /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.
| 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. |
testing
One-command multilingual blog creation. Writes a blog post, translates it into user-specified languages, applies cultural adaptation, and emits hreflang tags, sitemap entries, and a CMS-ready language map. The complete write-to-publish pipeline for international content. Orchestrates blog-write, blog-translate, blog-localize, and (optionally) seo-hreflang. Use when user says "multilingual blog", "blog multilingual", "write in multiple languages", "international blog", "mehrsprachiger Blog", "blog multilingue", "blog multilingue", "create blog in German and French".
development
Research what people are actually saying about a topic in the last 30 days across Reddit, X / Twitter, YouTube, Hacker News, dev.to, Medium, and other public discourse platforms. API-free; uses WebSearch with platform-targeted site operators plus recency filters. Produces DISCOURSE.md (a structured brief) and JSON output the writer can consume. Complements blog-researcher (which focuses on authority sources) with a recency-and-engagement lens. Use when user says "blog discourse", "discourse research", "what are people saying about", "research what people are saying", "voice of customer", "social listening", "30-day research", "trend research", "what's the discussion on", "real-time research", "practitioner discourse", "/blog discourse".
documentation
Establish durable brand and voice context for cross-skill consumption. Generates BRAND.md (audience, positioning, do/don't editorial rules, taboo phrases, competitor differentiation) and VOICE.md (existing persona JSON re-expressed as readable prose), both written to the project root. When present, all blog sub-skills auto-load these files before writing or reviewing. Pairs with blog-persona, which manages the structured persona JSON. Use when user says "blog brand", "create brand context", "brand voice doc", "BRAND.md", "VOICE.md", "establish editorial brand", "brand guidelines for blog".
development
Server-side tracking pipeline audit covering server-side Google Tag Manager (sGTM), Meta CAPI Gateway, Conversions API health, event deduplication via event_id, server-side hit ratio targets, pixel debugging, and PII hashing discipline. Use when user says server-side tracking, sGTM, server-side GTM, server-side tagging, CAPI, Conversions API, CAPI Gateway, Meta Conversions API, event deduplication, event_id, pixel debug, pixel health, Pixel/CAPI audit, first-party tracking, iOS 14.5 recovery, or server-side hit ratio.