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, citation capsules, 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

70%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 thorough, well-sequenced workflow with strong validation feedback loops and concrete templates, but it is on the verbose side and its many cross-references point to files that are not present in the skill bundle.

Suggestions

Ship the referenced bundle files (skills/blog/references/*.md, skills/blog-write/references/delivery.md, scripts/blog_preflight.py, agents/blog-writer.md) inside the skill tarball, or inline the essential parts so the signaled references resolve.

Tighten the content: drop the 'why this matters' rationale for year-anchors, contractions, and burstiness, and convert the 18-item quality checklist into a compact validation gate reference.

Confirm the preflight script path and command match the actual bundled script so the executable guidance is runnable as written.

Dimension	Reasoning	Score
Conciseness	Mostly efficient but includes several padded sections — rationale for year-anchors ('future readers and AI crawlers verify'), contractions/burstiness rationale, and an 18-item quality checklist — that could be tightened; it is below the 'efficient, minor trimming' (4) midpoint.	3 / 5
Actionability	Provides concrete executable guidance — frontmatter template, answer-first code block, citation capsule example, embedding snippets, and the `python3 scripts/blog_preflight.py` command — but several referenced scripts/files are not present in the bundle, leaving minor gaps.	4 / 5
Workflow Clarity	The 8-phase sequence (Phase 0–7) has explicit validation checkpoints, and Phase 6.5 is a full feedback loop — 5-gate delivery contract, blocking reviewer, max 3 iterations, capture preflight-report.json, re-dispatch on block — matching the validate→fix→retry anchor.	5 / 5
Progressive Disclosure	Structure is well-organized with one-level-deep references, but scored against the actual bundle: the references/scripts/assets dirs are absent and none of the cross-referenced files (skills/blog/references/*, skills/blog-write/references/delivery.md, scripts/blog_preflight.py, agents/blog-writer.md) exist, so signaled navigation is broken in practice.	3 / 5
	Total	15 / 20 Passed

Description

100%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, third-person description that comprehensively states capabilities and provides explicit natural trigger phrases for when to use it. Voice is consistent throughout and it clearly separates 'what' from 'when'.

Dimension	Reasoning	Score
Specificity	The description lists many concrete actions — 'template selection, answer-first formatting, Key Takeaways summary box, information gain markers, citation capsules, sourced statistics, Pixabay/Unsplash images, built-in SVG chart generation, optional FAQ sections, internal linking zones, and proper heading hierarchy' — giving comprehensive coverage matching the score-5 anchor.	5 / 5
Completeness	It explicitly answers both 'what' (the full action list) and 'when' with concrete trigger phrases in the 'Use when user says ...' clause, matching the score-5 anchor.	5 / 5
Trigger Term Quality	It includes multiple natural trigger phrases users would actually say — 'write blog', 'new blog post', 'create article', 'write about', 'draft blog', 'generate blog post' — matching the comprehensive-coverage anchor.	5 / 5
Distinctiveness Conflict Risk	The 'from scratch / new article' niche plus explicit quoted trigger phrases give it a clear niche with minimal conflict risk against sibling blog skills.	5 / 5
	Total	20 / 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: brain/.raw/sources/claude-blog-skill/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.