# Doc Author

Write, edit, and maintain documentation.

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

## Install

Claude Code: `npx skills add InsForge/InsForge --skill doc-author -g -a claude-code -y`
Codex: `npx skills add InsForge/InsForge --skill doc-author -g -a codex -y`
Cursor: `npx skills add InsForge/InsForge --skill doc-author -g -a cursor -y`
Gemini CLI: `npx skills add InsForge/InsForge --skill doc-author -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add InsForge/InsForge`

## Description

Write, edit, and maintain documentation. Use for collaborative drafting, autonomous writing, or improving existing docs. Defaults to collaborative mode where the human makes final decisions. Built by Mintlify.

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

<!--
  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

The rest: https://github.com/InsForge/InsForge/blob/HEAD/.claude/skills/doc-author/SKILL.md