CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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.

The body delivers a well-sequenced, highly actionable drafting workflow with explicit user-approval checkpoints and an iteration loop, and its templates make outputs consistent. It loses points for token efficiency (generic writing tips, redundant Notes, and a time-sensitive version/date footer) and for inlining template content that belongs in reference files.

Suggestions

Remove the 'Tips for Quality' section: hook/flow/voice/CTA advice is generic writing knowledge Claude already has; keep only the citation requirements, which are already covered in Step 6.

Drop the footer metadata ('Last Updated', 'Claude Code Version', 'Compatible Models') — time-sensitive information that will go stale and adds no execution value.

Move the three templates (source summary, outline structure, draft format) into references/ files (e.g., references/templates.md) and link to them from the steps, shortening SKILL.md to the workflow itself.

DimensionReasoningScore

Conciseness

The Step 0-9 core is efficient, but 'Tips for Quality' (e.g., 'Start with a question, surprising fact, or relatable scenario', 'Each paragraph should connect to the next') is generic writing knowledge Claude already has, 'Notes' repeats the steps, and the footer carries time-sensitive metadata ('Last Updated: August 4, 2026', 'Claude Code Version: 2.1.220', 'Compatible Models'), which the guidelines penalize. Not a 2 because the bulk of the workflow is tight and template-driven rather than padded explanation; not a 4 because of the penalized version/date footer and the redundant tips section.

3 / 5

Actionability

Concrete guidance throughout: file naming schemes ('YYYY-MM-DD-short-topic-name', 'draft-v0.1.md'), commit message templates ('docs: Add outline for blog post - [topic-name]'), and citation formats with worked examples ('Studies show that 65% of developers prefer TypeScript [1]'). Not a 5 because git operations are described ('Stage the new files... Push to remote') rather than given as executable commands, and no commands exist for folder creation.

4 / 5

Workflow Clarity

Steps 0-9 are clearly sequenced with explicit validation checkpoints ('Wait for user responses before proceeding', 'Present outline to user and ask for approval or modifications', 'Confirm folder creation with user') and an explicit feedback loop (Step 9 'Return to Step 6' with version incrementing). Conditional branching (existing post -> skip to Step 9, git vs non-git repo) is handled explicitly; no destructive or batch operations lack validation.

5 / 5

Progressive Disclosure

The single file is well-sectioned with clear headers, but no references/ bundle exists and substantial template content is inlined (the source summary template, the full outline template, and the draft format template) that could live in separate reference files. This matches the 3 anchor of content that should be separate being inline; not a 2 because the document is well-organized and navigable rather than a monolithic wall.

3 / 5

Total

15

/

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.

The description is strong: it uses third person, states concrete pipeline capabilities, and includes an explicit 'Use when...' clause with natural trigger phrases. Its only weaknesses are slightly generic stage-level action names and the mildly broad 'create content from research' trigger, which introduces minor overlap risk with adjacent writing/research skills.

DimensionReasoningScore

Specificity

Quotes: 'Draft a blog post from ideas and resources' and 'Guides through research, brainstorming, outlining, and iterative drafting with version control' name the domain plus several concrete actions. Not a 5 because the actions are pipeline stage names rather than the fully enumerated, fine-grained capability list of the top anchor; not a 3 because coverage goes well beyond 1-2 actions.

4 / 5

Completeness

Quotes: 'Draft a blog post from ideas and resources... Guides through research, brainstorming, outlining, and iterative drafting with version control' (what) and 'Use when users want to write a blog post, create content from research, or draft articles' (when). Both are explicitly and clearly answered with concrete trigger phrases, matching the top anchor; the 4-anchor requires a weaker or less explicit 'when', which does not apply.

5 / 5

Trigger Term Quality

Quotes: 'write a blog post', 'create content from research', 'draft articles' are phrases users would naturally say. Good coverage but a few natural variations are missing (e.g., 'article', 'blog', 'write-up'), so it sits between the good (4) and comprehensive (5) anchors.

4 / 5

Distinctiveness Conflict Risk

Quotes: 'Draft a blog post', 'draft articles' establish a clear blog-drafting niche with minimal conflict risk. Not a 5 because 'create content from research' is somewhat broad and could overlap with research-summary or report-writing skills.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.