Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
64
51%
Does it follow best practices?
Impact
77%
1.50xAverage 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, language, and formatting rules
No Latin abbreviations
100%
100%
'lets you' phrasing
100%
100%
No 'should' usage
100%
100%
Contractions used
42%
100%
Sentence case headings
20%
100%
Paragraph before lists/subheadings
70%
70%
Text wrapped at 80 characters
0%
100%
'Gemini CLI' naming
100%
100%
Numbered steps for procedure
70%
90%
Meaningful example names
100%
100%
BLUF introduction
100%
100%
Quota/limit terminology and callout formatting
'quota' for admin concept
58%
100%
'limit' for numerical ceiling
58%
100%
'usage' for consumption tracking
87%
87%
Blocked-state combines both
50%
100%
prettier-ignore before callout
0%
100%
Callout type on first line
0%
100%
Callout continuation lines
0%
100%
<details> for reference data
0%
100%
Paragraph before lists/subheadings
60%
70%
Next steps section present
100%
100%
Editing docs: TOC removal, deep links, experimental notes
TOC removed
0%
0%
Heading renamed
100%
100%
Experimental NOTE present
0%
0%
Experimental NOTE placement
0%
0%
prettier-ignore before NOTE
0%
0%
Absolute link fixed
100%
100%
Deep link updated
100%
100%
Link text updated
0%
0%
9f76f34
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.