Skip to content
seo-flow logo

FLOW Framework — Find · Leverage · Optimize · Win

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 wan...

SKILL.md

Full skill instructions

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

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: python3 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

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.

More skills from gabrielmoreira

workflow-router logo
gabrielmoreira/agent-skills-mirror

workflow-router

研发工作流入口 - 帮助用户快速进入正确的工作流阶段。 触发关键词: 工作流, 流程, 从哪开始, 帮我, 我该怎么做, 下一步, workflow, 不知道用什么, 新手引导, 怎么用

19 0
View
平台架构知识 logo
gabrielmoreira/agent-skills-mirror

平台架构知识

Periodically refreshed mirror of agents, skills, prompts and instruction files from public repositories.

19 0
View
unity-profiler logo
gabrielmoreira/agent-skills-mirror

unity-profiler

Read-only Unity runtime performance snapshots — FPS, frame time, batches/draw calls, triangles/vertices, memory (total/mono/per-asset), object counts, AssetBundle stats. Exact signatures via GET /skills/schema.

19 0
View
ads-audit logo
gabrielmoreira/agent-skills-mirror

ads-audit

Full multi-platform paid advertising audit with parallel subagent delegation. Analyzes Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, and Apple Ads accounts via 6 parallel audit agents. Amazon Ads, cross-platform attribution, and server-side tracking are covered by their standalon...

19 0
View
unity-skills logo
gabrielmoreira/agent-skills-mirror

unity-skills

Unity Editor automation via REST API — create scripts, analyze scenes, manage assets, control editor, orchestrate workflows, run batch jobs, and route by Unity version. Triggers: Unity, Unity Skills, in Unity, automate Unity, Unity editor automation, create Unity script, scene summary, analyze Un...

19 0
View
purple-cow-audit logo
gabrielmoreira/agent-skills-mirror

purple-cow-audit

Score product remarkability 1-10 to decide if it's worth promoting. Seth Godin's Purple Cow test. Triggers on: "is this product worth promoting", "should I promote", "product audit", "purple cow", "remarkable product", "is it remarkable", "rate this product", "product quality check", "worth my re...

19 0
View
unity-cleaner logo
gabrielmoreira/agent-skills-mirror

unity-cleaner

Project cleanup and audit — find unused assets, content-hash duplicates, missing references, empty folders, large assets, dependency trees; two-step confirm-token delete. Exact signatures via GET /skills/schema.

19 0
View
skill-manager-guide logo
gabrielmoreira/agent-skills-mirror

skill-manager-guide

**GUIDE SKILL** — Guide to the Skill Manager for Copilot extension. USE FOR: adding/removing skill repos, syncing skills, pushing feedback, configuring sync intervals, troubleshooting sync issues, understanding skill format. DO NOT USE FOR: creating new skills (use skill-creator), creating agents...

19 0
View
configure-nightwatch logo
gabrielmoreira/agent-skills-mirror

configure-nightwatch

Configures Laravel Nightwatch data collection, sampling rates, filtering rules, and redaction policies. Use when setting up Nightwatch, managing data volume, protecting sensitive data (PII), or optimizing event collection for production workloads.

19 0
View
research-and-write logo
gabrielmoreira/agent-skills-mirror

research-and-write

End-to-end workflow: research a topic and then write a LinkedIn post about it. Use this skill whenever the user wants the full pipeline — from a topic idea to a finished LinkedIn post. Triggers on: 'research and write a post about', 'create a LinkedIn post about [topic]', 'I want to post about', ...

19 0
View
AI Tutor Persona logo
gabrielmoreira/agent-skills-mirror

AI Tutor Persona

Periodically refreshed mirror of agents, skills, prompts and instruction files from public repositories.

19 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View