CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-article

Writes a technical tutorial, blog post, or doc from a brief in briefs/, in Daisy's voice, and exports paste-ready files for Medium, Substack, and dev.to. Use when Daisy asks to write, draft, or create an article, post, tutorial, or doc.

Quality

92%

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

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

An exceptionally lean and executable workflow: concrete commands, explicit approval gates, and a validation feedback loop, with detail correctly delegated to referenced project files. The only defect found is the duplicated "1. 1." step marker in Stage 4, and Stage 6 lacks a light verification of the exported files before announcing readiness.

Suggestions

Fix the duplicated list marker in Stage 4 ("1. 1. Write `draft.md`...") so each step is numbered exactly once.

Add a light validation step in Stage 6 before telling Daisy the files are ready — e.g., confirm devto.md front matter is well-formed (title, published: false, description, exactly 4 tags) and that preview.html renders.

DimensionReasoningScore

Conciseness

The body is entirely imperative, staged instructions with zero concept explanations or padding — every line from the brief-field checks to the dev.to front-matter block is operational. It assumes Claude's competence and every token earns its place, matching the top anchor.

5 / 5

Actionability

Guidance is fully executable: exact commands with arguments ("python scripts/check_draft.py output/<slug>/draft.md", "python scripts/make_preview.py output/<slug>"), a named conda environment, a defined success condition ("until it prints `All checks passed`"), an exact "<!-- VERIFY: reason -->" convention, and a copy-paste dev.to front-matter template.

5 / 5

Workflow Clarity

Six ordered stages with "Never skip a stage", two explicit approval checkpoints, do-not-proceed guards, and a fix-and-rerun feedback loop — this exceeds the anchor-4 profile (which permits validation gaps). It falls short of a clean 5 only because Stage 4 step 1 contains a malformed duplicated step marker ("1. 1. Write `draft.md`..."), a visible defect in the written sequence.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~54-line body is well-organized into stage sections that appropriately delegate detail one level deep via clearly signaled paths (briefs/_template.yaml, voice-samples/, scripts/check_draft.py, CLAUDE.md sections) — matching the anchor for a clear overview with well-signaled one-level-deep references.

5 / 5

Total

19

/

20

Passed

Description

88%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 description that explicitly states both what the skill does and when to use it, with concrete platforms and a personalized niche. Its only weaknesses are a slightly incomplete set of natural trigger synonyms (no "blog"/"publish") and the mildly generic "doc" trigger that could collide with document-creation skills.

DimensionReasoningScore

Specificity

"Writes a technical tutorial, blog post, or doc from a brief in briefs/, in Daisy's voice, and exports paste-ready files for Medium, Substack, and dev.to" names the input, output types, voice constraint, and three concrete export targets — comprehensive coverage of the skill's actions with no visible gaps, matching the anchor for multiple specific concrete actions.

5 / 5

Completeness

It explicitly answers both questions: what ("Writes a technical tutorial, blog post, or doc from a brief... exports paste-ready files for Medium, Substack, and dev.to") and when ("Use when Daisy asks to write, draft, or create an article, post, tutorial, or doc") with concrete trigger phrases — a clear match for the top anchor.

5 / 5

Trigger Term Quality

The "Use when Daisy asks to write, draft, or create an article, post, tutorial, or doc" clause covers good natural verbs and nouns, but misses common variations such as "blog", "publish", or "write-up" — good keyword coverage with a few natural terms missing, not the full synonym coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

The personal article pipeline (briefs, Daisy's voice, platform exports) is a clear niche, but the generic trigger term "doc" could overlap with general document-creation skills — mostly distinct with minor overlap risk, fitting anchor 4 better than anchor 5's minimal-conflict profile.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

Daisy-Faith-Auma/writer-agent

Path

.claude/skills/write-article/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.