# Doc Coauthoring For Reviewers

> Sub-skill of doc-coauthoring: For Reviewers (+2).

- Skill: `vamseeachanta/doc-coauthoring-for-reviewers` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/doc-coauthoring-for-reviewers`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/doc-coauthoring-for-reviewers/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/doc-coauthoring-for-reviewers

---


# For Reviewers (+2)

## For Reviewers


1. **Be specific**: Point to exact text, not vague areas
2. **Be constructive**: Offer solutions, not just problems
3. **Prioritize**: Distinguish critical from nice-to-have
4. **Explain reasoning**: Help author learn and decide
5. **Respect voice**: Preserve author's style where appropriate


## For Authors


1. **Consider all feedback**: Even if not accepting
2. **Ask clarifying questions**: Before dismissing suggestions
3. **Track decisions**: Note why changes were accepted/rejected
4. **Thank reviewers**: Acknowledge contribution


## For Both


1. **Agree on process**: Establish review expectations upfront
2. **Set timelines**: Clear deadlines for each review round
3. **Use consistent tools**: Same markup/format for all feedback
4. **Communicate changes**: Notify when versions are ready