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.
SkillScore45Maintained
Automatic
◆Doc Ops pack
Last verified 9/27/2026
What it changes
Passed 5 of 11 test cases with the skill, and 3 of 11 without it.
Without skill27%
With skill45%
Checks it passed that the model alone missed
Refrains from executing docs verification commands on non-docs root files.
Concludes the document creation process by running repository validation scripts.
Advises reading docs-principles.md as the initial step before any other guidance file.
and 4 more in the full report
6 fixed4 passed either way10 still failing2 broke
Pass-rate lift
+18 pp
Tokens
+65%
Agent turns
0%
Response time
-38%
Model gemini-3.6-flashMeasured 9/27/2026v310 of 22 cases passed with skill · 11 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 5 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 5
Prompt
We just launched a new feature called 'Component Automated Mocking'. There is no existing documentation for it under `/docs`. I need you to write a brand new page at `/docs/writing-tests/automocking.md`. What workflow mode applies and what is the final step?
What was checked, without and with the skill
Checked
Without skill
With skill
Selects author mode for creating a new documentation page from scratch.
Passed
Passed
Concludes the document creation process by running repository validation scripts.
Missed
Passed
case-19 · gemini-3.6-flash · 9/27/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md146 lines5 files
Documentation Review
Scope
This skill applies to documentation files in /docs and docs-owned snippet files in docs/_snippets/. Do not use this skill for non-docs files (code, configuration, READMEs outside /docs).
Use This Skill When
Asked to review, improve, rewrite, or author documentation in /docs.
Asked for advice on page structure, doc type, audience, or content strategy for /docs.
Asked to fix formatting, style, or compliance issues in /docs.
Use a Light Touch When
The request is a trivial grammar or typo fix that does not need full diagnosis.
The page is already structurally sound and only needs minor editorial cleanup.
Reference Files
This skill uses four reference files under references/. Load them in order and only as needed:
File
Owns
When to Load
references/docs-principles.md
North star, quality dimensions, dual-reader requirement