CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

69

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 well-crafted instruction skill: concrete executable commands, a clearly sequenced workflow with explicit validation checkpoints, and disciplined conciseness with no filler. The only notable gap is that the referenced guideline files (AGENTS.md, STYLE.md, etc.) are not present in the bundle and their path context is not clarified.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no padding, no explaining concepts Claude already knows, concrete before/after examples like '"perform an evaluation of" becomes "evaluate"'. Anchor 4 ('efficient; minor instances that could be trimmed') fits better than 5 because a few lines (e.g., the Notes on vendored paths, the rationale sentence about reviewers) carry slightly more context than strictly necessary, though nothing is wasted enough to drop to 3.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: `git checkout -b fix/issue-<number>-<short-desc> main`, `scripts/lint.sh <changed-markdown-files>`, the complete commit heredoc with mandatory body, and `git log --all --full-history -- "**/filename.md"` for renames. This matches anchor 5 — specific commands cover the common cases, including validation of staged files via `git diff --cached --name-only`.

5 / 5

Workflow Clarity

The numbered workflow (branch → read then edit → front matter check → validate → self-review → commit) is clearly sequenced with explicit validation checkpoints: automated rumdl after each edit via the PostToolUse hook, manual lint after all edits, re-reading changed files, `git diff` verification of intended changes, and staged-file verification before commit. This matches anchor 5's 'clear sequence with explicit validation steps; feedback loops' — including fixing lint errors before proceeding.

5 / 5

Progressive Disclosure

Sections are well-organized and the body stays lean (~105 lines), pushing style detail to referenced files (AGENTS.md, STYLE.md, CLAUDE.md, COMPONENTS.md) one level deep. However, the actual bundle contains only scripts/post-edit.sh — none of the referenced guideline files exist in the bundle, and their location (bundle vs. repo) is not clearly signaled, matching anchor 4 ('good structure; references mostly clear; minor organization gaps') rather than anchor 5's well-signaled, verifiable references.

4 / 5

Total

18

/

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: third-person-style concrete actions, explicit and varied trigger phrases, an explicit exclusion clause, and clear niche positioning. It fully answers both what the skill does and when to use it.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Write or edit reader-facing technical prose', 'handles edits, formatting, self-review, and commits' — with only minor coverage gaps (e.g., no mention of specific doc types it edits like READMEs or blog posts). It sits at anchor 4 ('lists several specific actions; minor gaps') rather than 5 because coverage is not fully comprehensive, and well above anchor 3 since it names multiple actions, not just 1-2.

4 / 5

Completeness

It explicitly answers 'what' ('Write or edit reader-facing technical prose for immediate comprehension... handles edits, formatting, self-review, and commits') and 'when' with concrete trigger phrases ('Use for documentation, PR titles and descriptions... Also use when asked to make writing clearer...'), plus a negative trigger ('Do not use for code-only tasks'). This matches anchor 5 exactly; anchor 4 would require the 'when' to be less explicit, but here triggers are concrete and multiple.

5 / 5

Trigger Term Quality

Natural trigger phrases users would say include 'documentation', 'PR titles and descriptions', 'release notes', 'design documents', and 'make writing clearer, more natural, less AI-generated, or easier to read'. A few common variations (e.g., 'docs', 'README', 'blog post') are missing, matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — reader-facing prose quality, 'less AI-generated' writing, PR descriptions — with distinct triggers and an explicit exclusion for code-only tasks. Minor overlap risk remains with general documentation-fixing and commit-message skills, matching anchor 4 ('mostly distinct; minor overlap risk with closely related skills') rather than anchor 5's minimal conflict risk.

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