# Draft Stronger Documents With Guided Coauthoring

Complex documents often fail because context stays implicit or structure arrives too late. This skill guides Claude, Codex, and Claude Code through gathering context, drafting sections, refining edits, and testing reader understanding.

## Install

```bash
npx skillstore add anthropics/doc-coauthoring
```

## Metadata

- Status: approved
- Slug: doc-coauthoring
- Skillstore revision: r1
- Version status: missing
- Tree hash: f47bf9dac4d5086a2ffb6690603a5ba76d812db5e230bd9c63c970595c960f79
- Author: anthropics
- GitHub username: anthropics
- License: MIT
- Repository: https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring
- Ref: 72d5025b022c77f7a51bdf5c1637c689c80e89d1
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 79
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/doc-coauthoring
- Manifest: https://skillstore.pages.dev/api/skills/doc-coauthoring/manifest

## Capabilities

- Runs a three-stage workflow for context gathering, section refinement, and reader testing.
- Asks targeted questions about audience, goals, templates, constraints, and missing context.
- Builds document structure with section placeholders before drafting detailed content.
- Guides iterative section edits using specific feedback instead of full document rewrites.
- Suggests reader testing questions and checks for ambiguity, assumptions, and contradictions.
- Adapts to available artifacts, local files, integrations, or manual testing workflows.

## Use Cases

- Write a Technical Spec: Turn architecture notes and constraints into a structured technical specification with clear trade-offs.
- Draft a Decision Document: Capture decision context, alternatives, risks, and expected impact for stakeholders.
- Prepare a Proposal: Develop a proposal section by section and test whether readers understand the recommendation.

## Prompt Templates

### Start a New Document

```
Help me coauthor a document about [topic]. Ask me the initial context questions, then guide me through structure and drafting.
```

### Organize Existing Notes

```
I have rough notes for a [document type]. Help me identify the audience, goal, structure, and first section to draft.
```

### Refine a Difficult Section

```
Help me improve the [section name] section. Ask clarifying questions, brainstorm possible points, then draft a focused revision.
```

### Test Reader Understanding

```
Test this document as a new reader. Predict likely reader questions, identify ambiguity, and suggest specific fixes for weak sections.
```

## Limitations

- It does not verify factual accuracy without user review or reliable source material.
- It cannot access team channels or shared documents unless approved integrations are available.
- It depends on the user to provide organizational context and final ownership decisions.
- Reader testing may be manual when sub-agents or fresh model sessions are unavailable.

## Best Practices

- Provide audience, goals, constraints, templates, and relevant background before asking for polished prose.
- Work section by section so feedback can improve later sections.
- Use reader testing before sharing important documents with real stakeholders.

## Anti Patterns

- Do not skip context gathering when the topic has hidden organizational or technical history.
- Do not ask for a full rewrite when focused section edits would preserve useful structure.
- Do not treat reader testing as fact checking for claims that need source verification.

## Security Audit

- Audited at: 2026-07-06T12:28:06.62\+00:00
- Summary: All static findings were reviewed against SKILL.md and are false positives. The skill contains documentation workflow guidance, user-confirmed connector use, and Markdown tool references, with no prompt injection or unsafe execution behavior found.

## Stats

- Views: 299
- Downloads: 29
- Favorites: 0
- Popularity score: 0