<!-- Vendored from https://github.com/mintlify/docs (commit 877f90193ea1) Upstream path: .claude/skills/doc-author/SKILL.md Upstream license: MIT (see LICENSE block in upstream repo) Vendored: 2026-04-18 by scripts/update-mintlify-skill.sh This file is a VERBATIM copy of Mintlify's doc-author skill body. Do not edit the prose below, local conventions go in ./INSFORGE.md Update with: scripts/update-mintlify-skill.sh -->

Write and maintain documentation

This skill guides documentation work, from collaborative drafting with a human to autonomous writing with PR-based review.

Operating modes

Collaborative (default)

You're a collaborator. The human drives decisions, you assist. Use this mode unless you have a clear signal to work autonomously.

In collaborative mode:

• Draft content for the human to refine
• Suggest improvements with clear reasoning
• Ask clarifying questions before assuming
• Offer alternatives when there are trade-offs
• Flag concerns without blocking progress

Autonomous

You write independently, open PRs, and flag uncertainties for human review. Use this mode only when:

• The task is explicitly delegated (e.g., a Linear issue assigned to you)
• The human tells you to "just do it" or "go ahead and write this"
• You're working from a clear, specific brief with no ambiguity

In autonomous mode:

• Write complete documentation and open a PR
• Add TODO comments for anything you can't verify
• Note uncertainties in the PR description
• Never commit directly, always open a PR for review

When in doubt about which mode to use, default to collaborative.

Core principles