Skip to content
cccskills
FreePublished on GitHub

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.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (46)

  • SKILL.md5.5 KB
  • 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

SKILL.md (original)

Review the instructions the agent will receive before you install.

FLOW Framework: Find · Leverage · Optimize · Win

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.

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

CommandWhat it does
/seo flowShow 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 promptsFull index of all 41 prompts (stage, name, trigger conditions)
/seo flow syncPull 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: "$(git rev-parse --show-toplevel)/.claude/skills/seo/bin/claude-seo" run 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

ScenarioAction
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 errorDisplay the script's stderr. Check rate limits: gh api rate_limit.
sync_flow.py auth errorRun gh auth login then retry.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

The English summary is being prepared. Showing the original description.

balsm-health/website3Updated Oct 18, 2026

seo

Free

Comprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews/ChatGPT/Perplexity. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed.

The English summary is being prepared. Showing the original description.

balsm-health/website3Updated Oct 18, 2026

Ahrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/mcp@0.0.11 server. Pairs with seo-backlinks for multi-source confidence weighting.

The English summary is being prepared. Showing the original description.

balsm-health/website3Updated Oct 18, 2026

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.

The English summary is being prepared. Showing the original description.

balsm-health/website3Updated Oct 18, 2026

Backlink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.

The English summary is being prepared. Showing the original description.

balsm-health/website3Updated Oct 18, 2026

Bing Webmaster Tools + IndexNow extension. Microsoft Copilot citations are fed by the Bing index; this skill makes Bing visibility, link data, and IndexNow URL submission first-class.

The English summary is being prepared. Showing the original description.

balsm-health/website3Updated Oct 18, 2026

See all skills by balsm-health

Report a problem with this skill