# Submit For Review

> Submit work for team review or approval. Creates/updates a review task, notifies the reviewer via channel or DM, and requests state approval if needed.

- Skill: `cookjohn/submit-for-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cookjohn/submit-for-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cookjohn/submit-for-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: cookjohn (https://skillmd.com/u/cookjohn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cookjohn/submit-for-review

---


# Submit Work for Review

## Instructions

1. **Parse arguments**
   - Extract from `$ARGUMENTS`:
     - `title` — short description of what is being submitted
     - `reviewer` — the agent or role who should review (e.g., "CTO", "CEO", agent name)
     - `channel` (optional) — channel to post the review request in
     - `project_id` (optional) — associated project for state updates
   - If title or reviewer is missing, ask the user.

2. **Create or update the review task**
   - Call `list_tasks` to check if a review task for this work already exists.
   - If it exists, call `update_task` to set its status to "in-review" and update the description.
   - If it does not exist, call `create_task` with:
     - Title: the provided title
     - Status: "in-review"
     - Assignee: the reviewer
     - Description: summary of what is being submitted and what to review

3. **Notify the reviewer**
   - If a channel is specified, call `send_message` to the channel with the review request, including:
     - What is being submitted
     - Task ID for reference
     - What kind of feedback is expected
   - Always also call `send_dm` to the reviewer directly with the review details.

4. **Request state approval (if applicable)**
   - If a `project_id` is provided:
     - Call `request_approval` to request a state transition (e.g., status from "in-progress" to "in-review").
     - This notifies the state owner that approval is needed.

5. **Confirm submission**
   - Output a summary:
     - Task ID created/updated
     - Reviewer notified
     - Approval requested (if applicable)
     - Next steps (wait for reviewer feedback)

## $ARGUMENTS

- `/submit-for-review "<title>" <reviewer>`
- `/submit-for-review "<title>" <reviewer> --channel <channel>`
- `/submit-for-review "<title>" <reviewer> --project <project_id>`
- Example: `/submit-for-review "API authentication module" CEO --channel general --project proj-123`