blog-draft

Draft a blog post from ideas and resources. Use when users want to write a blog post, create content from research, or draft articles. Guides through research, brainstorming, outlining, and iterative drafting with version control.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./03-skills/blog-draft/SKILL.md

Quality

Content

62%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 skill is a clear, well-sequenced multi-step workflow with strong validation checkpoints and actionable specifics. Its main weakness is verbosity and the absence of progressive disclosure, with inline templates and redundant tip sections inflating token count.

Suggestions

Move the large outline and draft template blocks into reference files (e.g. references/outline-template.md) and link to them, reducing the body's token footprint.

Merge the 'Tips for Quality' and 'Notes' sections into the relevant steps to eliminate redundancy with the instructions already given.

Trim or remove the boilerplate footer ('Last Updated', 'Claude Code Version', 'Sources', 'Compatible Models') since it adds time-sensitive, non-essential tokens.

Dimension	Reasoning	Score
Conciseness	The body is noticeably verbose: large inline outline/draft template blocks restate structure, and the 'Tips for Quality' and 'Notes' sections repeat guidance already given in the step instructions. Much could be trimmed without losing clarity.	2 / 5
Actionability	Provides concrete, executable guidance — folder naming format, file paths, commit message templates, citation formats, and an output file tree — with only minor gaps.	4 / 5
Workflow Clarity	Steps 0–9 are explicitly sequenced with user-approval checkpoints ('Wait for user responses before proceeding', 'ask for approval or modifications') and a clear feedback loop in Step 9 returning to Step 6.	5 / 5
Progressive Disclosure	Single monolithic file with no external references and all templates inlined; headers provide some structure, but content that could live in separate files (outline/draft templates, citation guide) is all inline.	3 / 5
	Total	14 / 20 Passed

Description

83%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 well-crafted description that clearly states both the capability and concrete trigger phrases in third person. It is specific, complete, and largely distinct from other skills.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('research, brainstorming, outlining, and iterative drafting with version control') in the blog-drafting domain, but coverage is slightly less comprehensive than the multi-action 5 anchor.	4 / 5
Completeness	Explicitly answers both what ('Draft a blog post... Guides through research, brainstorming, outlining, and iterative drafting with version control') and when ('Use when users want to write a blog post, create content from research, or draft articles') with concrete triggers.	5 / 5
Trigger Term Quality	Natural phrases users would say ('write a blog post, create content from research, or draft articles') give good coverage, though a few common synonyms are absent.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear blog-drafting niche with version control, but has minor overlap risk with generic content-creation skills.	4 / 5
	Total	17 / 20 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: luongnv89/claude-howto
Path: 03-skills/blog-draft/SKILL.md
Commit: 1c04dbf

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.