# Good Docs Writing

Writing style guide derived from Modal's documentation voice.

- Repository: https://github.com/ComposioHQ/composio (30865 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

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

## Description

Writing style guide derived from Modal's documentation voice. Apply when writing or editing docs, guides, tutorials, or technical prose that should read direct, second-person, confident, low-jargon, and example-first. Use to draft new docs in this voice or to revise existing prose toward it.

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

# Good docs writing

Write docs the way Modal writes them: direct, friendly, confident, and ruthlessly practical. Explain the _why_ in one breath, then show working code. Treat the reader as a capable developer who wants to ship, not a student who needs a lecture.

Read `references/style-guide.md` for the full rule set (Voice, Structure, Terminology, Punctuation, Code examples, Formatting) and apply every rule while drafting.

The rules that matter most, before you open the reference:

- Address the reader as "you", never "the user" or "one".
- Open with the concept or benefit in the first sentence. No throat-clearing.
- Put a minimal runnable example near the top, then explain what just happened.
- Remove every em-dash. Use a period, comma, colon, or parentheses instead.
- Cut vague intensifiers ("seamlessly", "powerful", "robust", "cutting-edge"). Show a thing being easy instead of calling it easy.
- Backtick every code identifier, command, parameter, path, and filename.

To review existing prose against these rules instead of drafting, use `good-docs-audit`.