blog-flow

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.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured with clear command routing, on-demand reference loading, and strong progressive disclosure verified against the real bundle. The main weakness is mild redundancy between the opening paragraphs and later sections that could be tightened for token efficiency.

Suggestions

Remove the verbatim repetition of 'turn query data, source notes, and page evidence into structured decisions instead of improvised prompts' between the opening summary and the next paragraph.

Consolidate the local-SEO exclusion rationale so it is stated once rather than repeated in both the intro and the Sync Script section.

Add a brief validation checkpoint to the find/optimize/win orchestration sequences (e.g., confirm prompt files loaded before applying) to push workflow clarity toward a 5.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and well-organized, but the phrase 'turn query data, source notes, and page evidence into structured decisions instead of improvised prompts' is repeated verbatim in the opening two paragraphs, and the local-SEO exclusion rationale is restated across the intro and Sync sections; tightening these would remove padding.	3 / 5
Actionability	Provides concrete commands, exact file paths ('references/prompts/find/'), and executable script invocations ('python3 scripts/sync_flow.py --dry-run', '--ref <sha>'), with an error-handling table of specific actions; minor gaps in that prompt-application steps stay at a guidance rather than literal-execution level.	4 / 5
Workflow Clarity	Each command has a clear numbered orchestration sequence with per-stage selection logic, and the sync flow includes validation/drift detection plus a 403-retry feedback loop; minor validation gaps in the non-sync stages keep it just below a 5.	4 / 5
Progressive Disclosure	Clear overview with one-level-deep, well-signaled references mapped to explicit load conditions ('Load on every /blog flow activation', 'Load on demand'), and the prompt content is appropriately split into per-stage subdirectories whose counts (5/21/3/1 = 30) match the actual bundle.	5 / 5
	Total	16 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it concisely states what the skill does, supplies an explicit 'Use when...' clause with natural trigger phrases, and occupies a distinctive niche. It is written in third person and avoids vague fluff.

Dimension	Reasoning	Score
Specificity	Names the domain ('FLOW framework integration for bloggers') and several concrete actions ('Evidence-led content workflow using the Find, Optimize, Win loop with stage-specific AI prompts'), but the actions are framed at framework-integration level rather than enumerating exhaustive concrete operations, leaving minor coverage gaps.	4 / 5
Completeness	Explicitly answers both 'what' (FLOW framework integration for bloggers running the Find/Optimize/Win loop with stage-specific prompts) and 'when' ('Use when user says...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural trigger phrases users would actually say — 'FLOW', 'FLOW framework', 'blog flow', 'evidence-led blogging', 'find optimize win', plus 'stage-specific blog prompts' — covering synonyms and natural phrasings.	5 / 5
Distinctiveness Conflict Risk	Clear niche (FLOW blog workflow) with distinctive triggers like 'FLOW framework' and 'blog flow' that are unlikely to fire for unrelated skills; minimal conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
referenced_paths_exist	Referenced path issues: 9 deeper-than-1-level	Warning

	Total	14 / 16 Passed

Repository: AgriciDaniel/claude-blog
Path: skills/blog-flow/SKILL.md
Commit: 84f7abf

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.