CtrlK
BlogDocsLog inGet started
Tessl Logo

write

Write a documentation fix on a branch. Makes the minimal change, formats, self-reviews, and commits. Use after research has identified what to change. "write the fix", "make the changes", "implement the fix for #1234".

94

1.35x
Quality

92%

Does it follow best practices?

Impact

99%

1.35x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

92%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description that clearly communicates the skill's purpose, workflow steps, and when to use it. The inclusion of example trigger phrases is excellent. The main weakness is that some trigger terms ('make the changes', 'implement the fix') are generic enough to potentially conflict with non-documentation fix skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: writes a documentation fix on a branch, makes minimal changes, formats, self-reviews, and commits. These are clear, actionable steps.

3 / 3

Completeness

Clearly answers both what (writes documentation fix, formats, self-reviews, commits) and when ('Use after research has identified what to change') with explicit trigger examples.

3 / 3

Trigger Term Quality

Includes natural trigger phrases users would actually say: 'write the fix', 'make the changes', 'implement the fix for #1234'. These are realistic user utterances that map well to the skill's purpose.

3 / 3

Distinctiveness Conflict Risk

While it specifies 'documentation fix' and 'on a branch', phrases like 'make the changes' and 'implement the fix' are fairly generic and could overlap with code fix skills or other implementation-oriented skills. The documentation focus helps but the trigger phrases are broad.

2 / 3

Total

11

/

12

Passed

Implementation

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-crafted, highly actionable skill with a clear sequential workflow, explicit validation steps, and lean prose that respects Claude's intelligence. The commit message template and lint verification steps are particularly strong. The only weakness is that referenced style guides (CLAUDE.md, STYLE.md, COMPONENTS.md) are mentioned without links or bundle support, slightly weakening progressive disclosure.

Suggestions

Link referenced files (CLAUDE.md, STYLE.md, COMPONENTS.md) with relative markdown links so Claude can navigate to them, or note they exist in the project root.

DimensionReasoningScore

Conciseness

Every section is lean and purposeful. No unnecessary explanations of what git, linting, or front matter are. Instructions assume Claude's competence throughout and each token contributes actionable value.

3 / 3

Actionability

Provides executable bash commands for branching, linting, staging, and committing. The commit message template is copy-paste ready with a complete heredoc structure. Specific file paths and naming conventions are given.

3 / 3

Workflow Clarity

Clear 6-step sequential workflow with explicit validation checkpoints: Prettier runs automatically post-edit, manual lint after all edits, self-review with git diff before committing. The feedback loop is present — fix lint errors, re-verify with git diff. The staged-files verification step prevents accidental commits.

3 / 3

Progressive Disclosure

References to CLAUDE.md, STYLE.md, and COMPONENTS.md are mentioned but not linked. No bundle files are provided to support these references. The content is well-organized with clear sections, but the external references are not clearly signaled as navigable links.

2 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

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.