Agent skill

Blog Flow

by AgriciDaniel in AgriciDaniel/claude-blog

FLOW framework integration for bloggers. An agent skill from AgriciDaniel/claude-blog.

MITAuto-check passedKnowledge Management

Install Blog Flow

skills CLI
$ npx skills add AgriciDaniel/claude-blog --skill blog-flow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-blog blog-flow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/blog-flow .claude/skills/blog-flow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
blog-flow
GitHub stars
2.3k
Used in
1 other repo
Token cost
~2k tokens
SKILL.md length
973 words
Files
38 (incl. scripts, references)
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

FLOW framework integration for bloggers. An agent skill from AgriciDaniel/claude-blog.

  • Works in 3 steps: Read references/flow-framework.md. → Show the FLOW stage overview with a… → Ask the user which stage matches their…
  • Evidence-led blogging
  • SKILL.md covers Commands, Orchestration Logic, Context Matching (Optimize… and Reference Files, plus 3 more sections
  • Calls python3 and gh; needs GITHUB_TOKEN

What it does

Blog Flow is an agent skill from AgriciDaniel/claude-blog. FLOW framework integration for bloggers. Evidence-led content workflow using the Find, Optimize, Win loop with stage-specific AI prompts from the FLOW knowledge base (30 blog-applicable prompts, CC BY 4.0). Use when user says "FLOW", "FLOW framework", "blog flow", "evidence-led blogging", "find optimize win", or wants stage-specific blog prompts.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 42 other files, including scripts and reference files (for example `references/bibliography.md`, `references/flow-framework.md` and `references/prompts/README.md`). Compatibility notes: Requires Claude Code and Python 3.11+ for the sync script

It sits in Knowledge Management, covering Knowledge bases. The repository describes itself as: Claude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at… The licence is MIT.

When your agent uses it

  • Evidence-led blogging
  • Find optimize win
  • Wants stage-specific blog prompts

Example prompts

  • “FLOW framework”
  • “blog flow”
  • “evidence-led blogging”
  • “/blog-flow”

Requirements

  • Python 3
  • A credential in GITHUB_TOKEN
  • Compatibility (from SKILL.md): Requires Claude Code and Python 3.11+ for the sync script

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read references/flow-framework.md.
  2. Show the FLOW stage overview with a one-line description of each stage.
  3. Ask the user which stage matches their current situation.

What it can do on your machine

Read from SKILL.md and the folder at commit 2500d4c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GITHUB_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires Claude Code and Python 3.11+ for the sync script

    From compatibility in the SKILL.md frontmatter.

Context cost

Blog Flow loads about 2k tokens when it runs, and up to ~24k if it reads all its reference files. Until then it costs about 90 tokens; SKILL.md has 973 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~24k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-blog at commit 2500d4c, republished under its MIT licence (© AgriciDaniel). 973 words, ~2,004 tokens.

Download SKILL.mdSave it as .claude/skills/blog-flow/SKILL.md (or your agent's skills folder). This skill also uses 37 other files; get the full folder from GitHub.
name
blog-flow
description
FLOW framework integration for bloggers. Evidence-led content workflow using the Find, Optimize, Win loop with stage-specific AI prompts from the FLOW knowledge base (30 blog-applicable prompts, CC BY 4.0). Use when user says "FLOW", "FLOW framework", "blog flow", "evidence-led blogging", "find optimize win", or wants stage-specific blog prompts.
compatibility
Requires Claude Code and Python 3.11+ for the sync script
user-invokable
true
argument-hint
[stage] [url|topic]
license
MIT
metadata.author
AgriciDaniel
metadata.version
2.2.0
metadata.category
blog

FLOW Framework for Bloggers (Find, Optimize, Win)

Runs FLOW Find/Optimize/Win prompts for a blog topic or URL, turning query data, source notes, and page evidence into structured decisions instead of improvised prompts.

Framework and prompts (c) Daniel Agrici, CC BY 4.0. Source: github.com/AgriciDaniel/flow

FLOW is an evidence-led operating model for retrieval, citation, and conversion workflows. Claude Blog integrates the FLOW prompt library so writers can turn query data, source notes, and page evidence into structured decisions instead of improvised prompts.

This skill exposes the three blog-relevant stages (Find, Optimize, Win) and keeps the single Leverage prompt available through the prompts index. The local-SEO prompts (GBP, citations, local audits) are intentionally excluded because they target brick-and-mortar work, not blogs.

Runtime context. Load references/flow-framework.md on every /blog flow activation. Load prompt files on demand only, scoped to the stage the user requests.


Commands

CommandWhat it does
/blog flowShow FLOW overview and stage menu
/blog flow find [topic|url]Find-stage: keyword discovery, intent mapping, gap analysis (5 prompts)
/blog flow optimize [url]Optimize-stage: select 2 to 3 most relevant prompts of 21 based on context
/blog flow win [url]Win-stage: BOFU, conversion, dual-surface scorecard (3 prompts)
/blog flow promptsFull index of all 30 blog-applicable prompts (Find, Leverage, Optimize, Win)
/blog flow syncPull latest prompt files from github.com/AgriciDaniel/flow

The single Leverage prompt (off-site authority) is reachable through /blog flow prompts and is not promoted to a top-level command, since most blog workflows route off-site work elsewhere.


Orchestration Logic

On /blog 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 the user which stage matches their current situation.
On /blog flow find [topic|url]
  1. Read all files in references/prompts/find/.
  2. Apply each prompt to the topic or URL, capturing demand and intent signals.
  3. Cross-reference: "For deeper briefs and outlines, see /blog brief <topic>, /blog outline <topic>, and /blog cannibalization to detect overlap with existing posts."
On /blog flow optimize [url]
  1. Read the file names in references/prompts/optimize/.
  2. Read prior context (target URL, niche, any prior skill output in this conversation, scoring deltas from /blog analyze).
  3. Select 2 to 3 most relevant prompts, then load only those files.
  4. Apply the selected prompts; note that the rest are accessible via /blog flow prompts.
  5. Cross-reference: "For deeper rewrites and validation, see /blog rewrite <file>, /blog seo-check <file>, /blog geo <file>, /blog schema <file>, and /blog factcheck <file>."
On /blog 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 repurposing, full-site health, and quality scoring, see /blog repurpose <file>, /blog audit, and /blog analyze <file>."
On /blog flow prompts
  1. Read references/prompts/README.md.
  2. Display the full index: 30 prompts grouped by stage (Find, Leverage, Optimize, Win) with name and trigger conditions.
  3. State that local-SEO prompts are excluded by design; point users to claude-seo (/seo flow local) if they need them.
On /blog flow sync
  1. Run: python3 scripts/sync_flow.py.
  2. Display the JSON summary (files added, updated, unchanged).
  3. Show the attribution notice after the sync completes.

Context Matching (Optimize stage)

The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:

  1. Niche (SaaS or B2B blog leans on-page plus technical; lifestyle leans freshness plus E-E-A-T; publisher leans authority plus citations).
  2. Prior skill output (/blog analyze E-E-A-T gap routes to authority prompts; /blog seo-check failures route to on-page prompts; /blog geo gaps route to extraction-format prompts).
  3. URL signals (commercial pages need conversion prompts; informational posts need freshness plus answer-first prompts).

Always surface exactly 2 to 3 prompts. State which prompts you chose and why.


Show full SKILL.md (358 more words)Show less

Reference Files

Load on demand. Do NOT load all at startup.

  • references/flow-framework.md. FLOW operating model. Load on every /blog flow activation.
  • references/bibliography.md. Evidence sources. Load when citing studies or statistics.
  • references/prompts/README.md. Prompt index. Load for /blog flow prompts.
  • references/prompts/find/. 5 prompts. Load for /blog flow find.
  • references/prompts/leverage/. 1 prompt. Load only when surfaced through /blog flow prompts.
  • references/prompts/optimize/. 21 prompts. Load selectively for /blog flow optimize.
  • references/prompts/win/. 3 prompts. Load for /blog flow win.

If references/ is missing, instruct the user to run /blog flow sync first.


Sync Script

scripts/sync_flow.py pulls prompt files from github.com/AgriciDaniel/flow and writes them under skills/blog-flow/references/. Stdlib only, HTTPS only, host-allowlisted to api.github.com, 5 MB response cap, atomic writes, path-traversal guarded.

Modes:

  • python3 scripts/sync_flow.py. Sync the latest version of every blog-relevant stage to disk and refresh the lockfile.
  • python3 scripts/sync_flow.py --dry-run. Report planned changes without writing.
  • python3 scripts/sync_flow.py --ref <sha>. Pin fetches to a specific FLOW commit SHA for reproducible installs.

The lockfile lives at skills/blog-flow/references/flow-prompts.lock and uses sha256sum-compatible format. Drift between the on-disk content and the lockfile is reported on every sync run.

The script syncs only blog-applicable stages (find, leverage, optimize, win). The local stage is intentionally skipped to keep the references directory aligned with the skill's surface area.

GitHub API calls are anonymous by default. If GITHUB_TOKEN is set in the environment, or gh auth token returns a token after a 403 response, the script retries the request with that token. No tokens are written to disk.


Attribution

Every /blog flow activation (any sub-command) outputs before analysis:

Framework and prompts (c) Daniel Agrici, CC BY 4.0. Source: github.com/AgriciDaniel/flow

Do not omit or modify the attribution. Synced files also carry an HTML comment license header injected by the sync script.


Error Handling

ScenarioAction
references/flow-framework.md missing"FLOW reference files not synced. Run: /blog flow sync."
Prompt file missing"Run /blog flow sync to pull the latest prompts from the FLOW repo."
sync_flow.py network errorDisplay the script's stderr. Check rate limits with gh api rate_limit if gh is installed.
sync_flow.py 403 after retrySet GITHUB_TOKEN or run gh auth login, then retry.
Path-traversal abortThe sync target tried to escape the references directory. Inspect the upstream repo and pin to a known-good --ref.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 37 other files (scripts, references) in skills/blog-flow of AgriciDaniel/claude-blog.

  • SKILL.md
  • references/bibliography.md
  • references/flow-framework.md
  • references/flow-prompts.lock
  • references/prompts/README.md
  • references/prompts/find/content-planning-for-topical-relevance-prompt.md
  • references/prompts/find/content-prioritization-prompt.md
  • references/prompts/find/keyword-research-prompt.md
  • references/prompts/find/keyword-variations-for-topical-relevance-prompt.md
  • references/prompts/find/prompt-audience-avatar.md
  • references/prompts/leverage/backlink-competition-prompt.md
  • references/prompts/optimize/ai-detector-test-follow-up-prompt.md
  • references/prompts/optimize/ai-supporting-pages-rewrite-prompt.md
  • references/prompts/optimize/basic-prompt.md
  • references/prompts/optimize/blog-post-outline-prompt.md
  • references/prompts/optimize/blog-post-writing-prompt.md
  • … and 22 more

Open the folder on GitHubat commit 2500d4c

Used in 1 other repository

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in AgriciDaniel/claude-blog, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Blog Flow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Blog Flow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Blog Flow this skillAgriciDaniel/claude-blog2.3k1 repos~2kAutomated safety check: PassMIT
Interlinked Markdown Wikiholon-run/holon154—~1.6kAutomated safety check: PassApache-2.0
AutoRAG LibrarianMarker-Inc-Korea/AutoRAG5.1k—~2.1kAutomated safety check: PassMIT
Ray Obsidian Vault Setupimraywang/rayskills159—~625Automated safety check: PassCustom licence
Docsgpt Guidewentorai/research-plugins2981 repos~1.6kAutomated safety check: NotesMIT
Solidworks Designhashgraph-online/awesome-codex-plugins1.3k—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Maintain a file-first, auditable Markdown knowledge base with stable pages, sources, wikilinks, backlinks, indexes, freshness, and reviewable health reports.

    154 GitHub stars~1.6k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • AutoRAG Librarian

    Marker-Inc-Korea/AutoRAG

    Searches, summarizes, compares and answers questions from an already configured AutoRAG librarian agent over local documents and authorized datasources.

    5.1k GitHub stars~2.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Ray Obsidian Vault Setup

    imraywang/rayskills

    Sets up, audits or incrementally upgrades a local Obsidian vault for knowledge work and content production, without overwriting or moving existing notes.

    159 GitHub stars~625 tokensUpdated 16 days ago
    Knowledge ManagementAuto-check passed
  • Docsgpt Guide

    wentorai/research-plugins

    Deploy DocsGPT for private document analysis and research knowledge bases

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Knowledge ManagementAuto-check: notes
  • Solidworks Design

    hashgraph-online/awesome-codex-plugins

    Plan, create, modify, inspect, repair, validate, save, and export SolidWorks parts, assemblies, and drawings.

    1.3k GitHub stars~1.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Customer Research

    w95/awesome-claude-corporate-skills

    Research customer questions by searching across documentation, knowledge bases, and connected sources, then synthesize a confidence-scored answer.

    239 GitHub stars~2.3k tokensUpdated 7 mo ago
    Knowledge ManagementAuto-check passed

More from AgriciDaniel/claude-blog

All 39 skills in this repo
  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check: notes
  • Blog Audio

    AgriciDaniel/claude-blog

    Generate audio narration of blog posts using Google Gemini TTS.

    2.3k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check: notes
  • Blog Notebooklm

    AgriciDaniel/claude-blog

    Query Google NotebookLM notebooks for source-grounded, citation-backed answers from user-uploaded documents.

    2.3k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check: warnings
  • Blog Image

    AgriciDaniel/claude-blog

    AI image generation and editing for blog content powered by Gemini via MCP.

    2.3k GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • Blog Cluster

    AgriciDaniel/claude-blog

    Semantic topic cluster planning and automated execution engine for claude-blog.

    2.3k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed
  • Blog Discourse

    AgriciDaniel/claude-blog

    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.

    2.3k GitHub starsUsed in 1 repo~3.4k tokens
    Auto-check: warnings

Questions about Blog Flow

What does Blog Flow do?

FLOW framework integration for bloggers. An agent skill from AgriciDaniel/claude-blog. Blog Flow is an agent skill from AgriciDaniel/claude-blog. FLOW framework integration for bloggers.

When should I use Blog Flow?

Blog Flow fits situations like: evidence-led blogging; find optimize win; wants stage-specific blog prompts.

How do I install Blog Flow in Claude Code?

Run `npx skills add AgriciDaniel/claude-blog --skill blog-flow -a claude-code`. Or copy the skill folder (skills/blog-flow in AgriciDaniel/claude-blog) into .claude/skills/blog-flow in your project. Claude Code loads it when a task matches its description.

How do I install Blog Flow in Codex?

Run `npx skills add AgriciDaniel/claude-blog --skill blog-flow -a codex`. Or copy the skill folder (skills/blog-flow in AgriciDaniel/claude-blog) into .agents/skills/blog-flow in your project. Codex loads it when a task matches its description.

Can I use Blog Flow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-blog --skill blog-flow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/blog-flow, .gemini/skills/blog-flow, .github/skills/blog-flow and .opencode/skills/blog-flow in your project.

What does Blog Flow need to run?

Going by SKILL.md and its folder, Blog Flow needs the command-line tools its instructions call (python3 and gh) and credentials named GITHUB_TOKEN. Our summary lists: Python 3; A credential in GITHUB_TOKEN. Compatibility (from SKILL.md): Requires Claude Code and Python 3.11+ for the sync script.

Does Blog Flow access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Blog Flow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Blog Flow use?

Blog Flow is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Blog Flow use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 22k tokens, read only when the agent opens those files.

What are the alternatives to Blog Flow?

Skills that share tags, products or a category with Blog Flow: Interlinked Markdown Wiki (holon-run/holon, 154 stars), AutoRAG Librarian (Marker-Inc-Korea/AutoRAG, 5.1k stars), Ray Obsidian Vault Setup (imraywang/rayskills, 159 stars) and Docsgpt Guide (wentorai/research-plugins, 298 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Blog Flow?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-blog, which has 2,347 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 9, 2026.

Source: AgriciDaniel/claude-blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.