# Bolta.add Comment

> Add a review comment to a draft without approving or rejecting - used for suggestions, questions, or notes

- Skill: `boltaai/bolta-add-comment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add boltaai/bolta-add-comment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/boltaai/bolta-add-comment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: boltaai (https://skillmd.com/u/boltaai)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/boltaai/bolta-add-comment

---


## Goal
Add a review comment to a draft without approving or rejecting it. Used for suggestions, questions, or notes during review process.

## Which Agents Use This
- **reviewer** — Add suggestions before approval, ask questions, note observations
- **custom** — Any agent participating in review process
- Humans can also add comments during review

## Hard Rules
1. MUST attach comment to post
2. SHOULD specify comment_type for context (suggestion, question, note, praise)
3. SHOULD be specific and actionable
4. Comments don't change post status (still in review)

## Steps

### 1. Validate input
- Verify post_id exists
- Verify comment is non-empty
- Validate comment_type if provided

### 2. Create comment
- Attach comment to post
- Record comment_type
- Record author (agent or human)
- Timestamp comment

### 3. Return confirmation
- Return comment_id and success message

## Output
```json
{
  "success": true,
  "comment_id": "uuid",
  "message": "Comment added to post."
}
```

## Failure Handling
- If post_id not found: return error "Post not found"
- If comment empty: return error "Comment text required"

## Example Usage

### Scenario 1: Reviewer adding suggestion
```json
{
  "post_id": "uuid",
  "comment": "Consider changing 'utilize' to 'use' (voice profile prefers simpler words)",
  "comment_type": "suggestion"
}
```
**Result:** Comment added to draft for creator to review

### Scenario 2: Reviewer asking question
```json
{
  "post_id": "uuid",
  "comment": "Is this stat current? I see different numbers in our latest report.",
  "comment_type": "question"
}
```
**Result:** Question flagged for creator or human to answer before approval