CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write

Write or edit reader-facing technical prose for immediate comprehension. Use for documentation, PR titles and descriptions, release notes, design documents, user-facing explanations, and substantive comments. Also use when asked to make writing clearer, more natural, less AI-generated, or easier to read. For documentation fixes, handles edits, formatting, self-review, and commits after research identifies what to change. Do not use for code-only tasks with no prose deliverable.

1.03x
Quality

90%

Does it follow best practices?

Impact

80%

1.03x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 exemplary instruction-only skill body: lean, concrete, and sequenced with genuine validation checkpoints at every stage, from lint feedback to staged-diff verification. The only weakness is that several referenced files (STYLE.md, COMPONENTS.md, AGENTS.md, CLAUDE.md, scripts/lint.sh) are absent from the bundle, leaving those guidance pointers unverifiable.

DimensionReasoningScore

Conciseness

The body is lean throughout: no concept explanations Claude already knows, no padding, and every line is directive ('Make the minimal change that fixes the issue', 'Don't interrupt a procedure... to insert a related fact'). Matches the 5 anchor: every token earns its place.

5 / 5

Actionability

Fully executable guidance: copy-paste-ready branch, lint, stage-verify, and heredoc commit commands with clear placeholders, plus concrete before/after rewrite pairs ('post-update configuration validation' becomes 'validate the configuration after the update'). Nothing is pseudocode or abstract-only, matching the 5 anchor.

5 / 5

Workflow Clarity

A clearly numbered branch→edit→front-matter→validate→self-review→commit sequence with explicit validation checkpoints ('Fix errors and warnings on lines you added or changed', 'Run git diff and verify only intended changes are present', 'git diff --cached --name-only') and a fix-and-review feedback loop. This matches the 5 anchor's explicit validation and error-recovery requirements.

5 / 5

Progressive Disclosure

Good single-file structure with well-organized sections and a one-level-deep reference pattern (hook script verified at scripts/post-edit.sh). However, the body cites AGENTS.md, STYLE.md, CLAUDE.md, COMPONENTS.md, and scripts/lint.sh, none of which exist in the bundle — a clear structure with unverifiable external references, keeping it at the 4 anchor rather than 5.

4 / 5

Total

19

/

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 strong description: concrete domain, explicit 'Use for' trigger list including the increasingly common 'less AI-generated' phrasing, and an explicit exclusion clause. It fully answers what and when, with only minor gaps in synonym coverage and slight overlap risk with generic documentation/commit skills.

Suggestions

Add common user phrasings as trigger synonyms, e.g. 'Use when asked to rewrite, tighten, or humanize text' or 'edit docs', to lift trigger-term coverage.

List one or two more concrete actions beyond write/edit (e.g., restructure a document or section, retitle a heading) so the action list is as comprehensive as the deliverable list.

Sharpen the exclusion clause with adjacent-skill boundaries (e.g., not for code refactoring or commit generation from diffs alone) to further cut overlap risk.

DimensionReasoningScore

Specificity

Names the domain ('Write or edit reader-facing technical prose') plus several concrete deliverable types (documentation, PR titles and descriptions, release notes, design documents, substantive comments) and post-fix actions ('handles edits, formatting, self-review, and commits'), but action coverage is slightly thinner than the deliverable enumeration. Not 5 because a few plausible actions (e.g., restructuring a document) are not covered; clearly above 3 given the multiple specific actions listed.

4 / 5

Completeness

Explicitly answers both questions with concrete trigger phrases: what ('Write or edit reader-facing technical prose for immediate comprehension') and when ('Use for documentation, PR titles and descriptions... Also use when asked to make writing clearer...'), plus an explicit negative trigger ('Do not use for code-only tasks with no prose deliverable'). Matches the 5 anchor directly.

5 / 5

Trigger Term Quality

Includes natural phrases users would actually say: 'documentation', 'PR titles and descriptions', 'release notes', 'clearer', 'more natural', 'less AI-generated', 'easier to read'. A few common variations (e.g., 'edit docs', 'rewrite this', 'make it sound human') are missing, keeping it just below comprehensive synonym coverage at 5.

4 / 5

Distinctiveness Conflict Risk

A clear reader-facing-prose niche with a disqualifier ('Do not use for code-only tasks with no prose deliverable') that sharply reduces wrong-skill triggering, but 'documentation' and 'PR descriptions' still overlap with general doc/commit-message skills. Not 5 due to that residual overlap with closely related skills; well above 3 because of the explicit boundary.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

docker/docs

Path

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