CtrlK
BlogDocsLog inGet started
Tessl Logo

docs-review

Review, improve, rewrite, author, or plan Storybook documentation in /docs. Use this when asked to review docs, improve a page, rewrite documentation, draft new docs, or advise on docs strategy.

72

Quality

91%

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

92%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-engineered skill body: a deterministic mode-routing workflow with validation feedback loops, all detail correctly pushed into four real one-level-deep reference files, and no padding. The only cost is mild redundancy where mode-specific guidance repeats routing and style-guide instructions already stated elsewhere.

DimensionReasoningScore

Conciseness

The body is dominated by terse tables and rules with no padding or explanation of concepts Claude already knows. Minor trimming is possible: 'Use `references/storybook-style.md` for the final pass' is repeated across four mode bullets, and Step 5's mode list restates routing already in Step 1's table — the redundancy keeps it at the 4 anchor rather than the lean 5.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: a request-pattern→mode table, a doc-type list, explicit intervention thresholds, a concrete strategy-artifact checklist, and exact commands ('yarn fmt:write', 'yarn docs:check'). Not the 4 anchor because no key detail is deferred without a pointer to the reference that owns it.

5 / 5

Workflow Clarity

A clearly sequenced 7-step workflow, explicitly split into diagnosis (1–4) and action (5–7), with a validation feedback loop ('Fix any errors reported by `yarn docs:check`, then run it again to confirm') and explicit guards ('Do not run validation in `strategy` mode') — matching the 5 anchor's validate→fix→retry structure.

5 / 5

Progressive Disclosure

The Reference Files table signals each of the four existing `references/` files with what it owns and when to load it, ownership rules prevent overlap, and loading is one level deep with no nested reference chains — the clear-overview-with-well-signaled-references structure of the 5 anchor.

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 follows the what-then-when pattern with concrete, user-natural trigger phrases covering all five skill modes. The only gaps are a few missing synonyms and mild overlap potential with generic documentation skills.

DimensionReasoningScore

Specificity

The description enumerates all five concrete capabilities of the skill — 'Review, improve, rewrite, author, or plan Storybook documentation in /docs' — matching the five modes defined in the body, which is comprehensive coverage rather than the partial list of the 4-anchor.

5 / 5

Completeness

It explicitly answers both questions: 'what' is the verb list scoped to Storybook documentation in /docs, and 'when' is a concrete 'Use this when asked to...' clause with trigger phrases — the exact structure of the 5 anchor's example.

5 / 5

Trigger Term Quality

The 'when' clause uses natural user phrasing ('asked to review docs, improve a page, rewrite documentation, draft new docs, or advise on docs strategy') that mirrors the capability verbs. A few common synonyms users might say ('edit', 'update', 'audit docs', 'fix formatting') are missing, so it falls just short of the comprehensive-synonym 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Scoping to 'Storybook documentation in /docs' carves out a clear niche, but the terms 'documentation' and 'review docs' could still collide with generic docs/lint skills in the same environment — minor overlap risk with closely related skills, matching the 4 anchor.

4 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
storybookjs/storybook
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.