Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
71
58%
Does it follow best practices?
Impact
91%
1.71xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.gemini/skills/docs-writer/SKILL.mdVoice, tone, and language style compliance
Gemini CLI naming
50%
100%
No 'please'
100%
100%
Active voice
80%
100%
No anthropomorphism
100%
100%
Contractions used
0%
100%
No 'e.g.'
100%
100%
No 'i.e.'
100%
100%
'lets you' not 'allows you to'
0%
100%
No ambiguous 'should'
100%
100%
'you' pronoun
100%
100%
Meaningful example names
100%
100%
Formatting and structural documentation standards
BLUF introduction
100%
90%
Heading overview paragraphs
20%
100%
No table of contents
100%
100%
Sentence case headings
50%
100%
80-character text wrap
0%
100%
Numbered steps
100%
100%
Prettier-ignore before callout
0%
100%
Callout alert format
0%
100%
Gemini CLI naming
62%
100%
Next steps section
0%
0%
Quota/limit terminology and link formatting
'quota' for admin concept
33%
75%
'limit' for numerical ceiling
16%
100%
Correct blocked-user phrasing
0%
100%
No 'click here' links
100%
100%
Descriptive link text
90%
90%
Relative links
100%
100%
Experimental note placement
0%
0%
Prettier-ignore before experimental note
0%
100%
Experimental note format
100%
100%
77e65c0
Table of Contents
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.