docs-writer

The `docs-writer` skill is designed to assist in writing, editing, and reviewing technical documentation specifically for the Gemini CLI project. It ensures that all content within the `/docs` directory or any `.md` files adheres strictly to project documentation standards. By applying consistent rules for tone, grammar, formatting, and style, this skill solves the problem of inconsistent, unclear, or inaccurate documentation, helping maintain professional quality across the codebase and supporting materials.

The skill provides a comprehensive approach to documentation creation. It emphasizes a clear, professional, and conversational tone, uses active voice and present tense, and avoids jargon, idioms, or unnecessary embellishments. It enforces precise grammar, punctuation, and concise language while guiding the formatting of headings, lists, code snippets, UI elements, and media files. It also includes specific instructions for creating collapsible sections, callouts, and accessible content. Additionally, the skill ensures that terminology related to quotas and limits follows project guidelines and that all examples are meaningful and contextually relevant.

This skill is particularly useful for technical writers, developers, and contributors working on the Gemini CLI project who need to produce high-quality, maintainable documentation. Typical use cases include writing new guides or API references, reviewing and updating existing documentation to match current code functionality, and ensuring accessibility and formatting consistency. By using the `docs-writer` skill, teams can save time on editorial decisions, reduce errors, and provide end users with clear, reliable instructions and resources.