# Doc Coauthoring 1 Suggestion Mode

> Sub-skill of doc-coauthoring: 1. Suggestion Mode (+3).

- Skill: `vamseeachanta/doc-coauthoring-1-suggestion-mode` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/doc-coauthoring-1-suggestion-mode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/doc-coauthoring-1-suggestion-mode/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-1-suggestion-mode

---


# 1. Suggestion Mode (+3)

## 1. Suggestion Mode


Provide non-destructive suggestions that the author can accept or reject.

**Format:**
```markdown
Original text here
--> **Suggested:** Revised text with improvements

**Reason:** Brief explanation of why this change improves the document.
```


*See sub-skills for full details.*

## 2. Track Changes Mode


Show exactly what was modified with clear before/after.

**Format:**
```markdown
~~deleted text~~ **added text**
```

**Example:**
```markdown
The meeting will be held ~~on Monday~~ **Tuesday at 2pm** in the main conference room.
```

## 3. Comment Mode


Add contextual feedback without changing text.

**Format:**
```markdown
[COMMENT: Your feedback here]
```

**Example:**
```markdown
Our Q3 revenue exceeded expectations by 15%. [COMMENT: Consider adding comparison to Q2 for context]
```

## 4. Section Rewrite Mode


Propose complete rewrites of sections.

**Format:**
```markdown
---
**ORIGINAL SECTION:**
[Original text]

**PROPOSED REWRITE:**
[New version]

*See sub-skills for full details.*