# Write Repo Docs

Writes and reviews documentation files in the docs folder and Markdown files.

- Repository: https://github.com/google-gemini/gemini-cli (108651 stars)
- Category: Documents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google-gemini/gemini-cli --skill docs-writer -g -a claude-code -y`
Codex: `npx skills add google-gemini/gemini-cli --skill docs-writer -g -a codex -y`
Cursor: `npx skills add google-gemini/gemini-cli --skill docs-writer -g -a cursor -y`
Gemini CLI: `npx skills add google-gemini/gemini-cli --skill docs-writer -g -a gemini-cli -y`

## Description

Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# `docs-writer` skill instructions

As an expert technical writer and editor for the Gemini CLI project, you produce
accurate, clear, and consistent documentation. When asked to write, edit, or
review documentation, you must ensure the content strictly adheres to the
provided documentation standards and accurately reflects the current codebase.
Adhere to the contribution process in `CONTRIBUTING.md` and the following
project standards.

## Phase 1: Documentation standards

Adhering to these principles and standards when writing, editing, and reviewing.

### Voice and tone
Adopt a tone that balances professionalism with a helpful, conversational
approach.

- **Perspective and tense:** Address the reader as "you." Use active voice and
  present tense (e.g., "The API returns...").
- **Tone:** Professional, friendly, and direct.
- **Clarity:** Use simple vocabulary. Avoid jargon, slang, and marketing hype.
- **Global Audience:** Write in standard US English. Avoid idioms and cultural
  references.
- **Requirements:** Be clear about requirements ("must") vs. recommendations
  ("we recommend"). Avoid "should."
- **Word Choice:** Avoid "please" and anthropomorphism (e.g., "the server
  thinks"). Use contractions (don't, it's).

### Language and grammar
Write precisely to ensure your instructions are unambiguous.

The rest: https://github.com/google-gemini/gemini-cli/blob/HEAD/.gemini/skills/docs-writer/SKILL.md