blog-write

Write new blog articles from scratch optimized for Google rankings and AI citations. Generates full articles with template selection, answer-first formatting, Key Takeaways summary box, information gain markers, evidence-backed explanations, sourced statistics, Pixabay/Unsplash images, built-in SVG chart generation, optional FAQ sections, internal linking zones, and proper heading hierarchy. Supports MDX, markdown, and HTML output. Use when user says "write blog", "new blog post", "create article", "write about", "draft blog", "generate blog post".

Quality

85%

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

73%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.

A well-structured, highly actionable multi-phase workflow with strong validation and feedback loops. Its main weakness is conciseness: the body is long with duplicated internal-linking guidance and overlapping image sections that could be consolidated.

Suggestions

Consolidate the duplicate internal-linking guidance: sections 5f (Internal Linking Zones) and 5n (Internal Linking) repeat the same 5-10 links/2,000-word rule — merge them into one and cross-reference it.

Tighten image guidance so Phase 2 (research/sourcing) and 5i (embedding) each cover only their distinct concern, removing the overlap between sourcing rules and placement rules.

Move the inline template-selection table and Phase 6 style-list of phrases into a reference file (e.g. content-templates.md / a style-list doc) and link to it, shortening the overview body.

Dimension	Reasoning	Score
Conciseness	Mostly efficient domain-specific guidance, but the ~480-line body carries redundancy — internal linking is covered twice (5f zones and 5n repeat) and image guidance overlaps Phase 2 and 5i — so it could be tightened.	3 / 5
Actionability	Provides concrete executable guidance (exact `python3 scripts/blog_preflight.py` commands, frontmatter template, citation format, outline skeleton, embed formats), with minor gaps where writing rules stay at a directive level.	4 / 5
Workflow Clarity	Phases 0–7 are clearly sequenced with explicit validation in Phase 6.5 (5-gate delivery contract, BLOCKING reviewer, re-dispatch feedback loop, max 3 iterations) and a Phase 6 quality checklist.	5 / 5
Progressive Disclosure	A clear 'Key references' section plus inline 'See `skills/blog/references/...`' signaling keeps references one level deep, but the long body inlines content that could be split out and most references point to a sibling skill's directory rather than this bundle.	4 / 5
	Total	16 / 20 Passed

Description

96%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.

A strong, comprehensive description that clearly states capabilities and provides explicit, natural trigger phrases. The only weakness is a slightly generic 'write about' trigger that could overlap with adjacent writing skills.

Dimension	Reasoning	Score
Specificity	Lists many concrete actions — 'template selection, answer-first formatting, Key Takeaways summary box... built-in SVG chart generation, optional FAQ sections, internal linking zones' — giving comprehensive coverage of what the skill does.	5 / 5
Completeness	Explicitly answers both 'what' ('Generates full articles with...') and 'when' ('Use when user says...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Six natural trigger phrases a user would actually say ('write blog', 'new blog post', 'create article', 'write about', 'draft blog', 'generate blog post') with synonym coverage.	5 / 5
Distinctiveness Conflict Risk	Clear new-article-from-scratch niche with distinct triggers, but the generic 'write about' phrase and a sibling `blog` skill family create minor overlap risk rather than minimal.	4 / 5
	Total	19 / 20 Passed

Validation

81%

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 — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 1 missing	Warning
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	13 / 16 Passed

Repository: AgriciDaniel/claude-blog
Path: skills/blog-write/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.