# review-proposals

Steps through pending playbook update proposals from the playbook-monitor agent and applies approved changes to the practice profile.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 608 installs · ★ 9795
- Author: anthropics · official Anthropic repository
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/anthropics/claude-for-legal/tree/HEAD/commercial-legal/skills/review-proposals/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/review-proposals

## What it does

The skill executes Step 5 of the `playbook-monitor` agent to run the review and approval flow. It reads the pending proposals file and presents changes one item at a time. No arguments are needed. If the proposals file is missing or empty, the skill responds that the playbook is up to date and stops.

Each proposal provides four explicit choices: Accept, Reject, Edit, or Defer. For Reject or Defer, the decision is logged while the practice profile remains untouched. For Accept or Edit, the agent shows the exact diff to `~/.claude/plugins/config/claude-for-legal/commercial-legal/CLAUDE.md`. Changes are never applied blindly. The file updates only after the attorney explicitly confirms.

Once all proposals are resolved, the skill displays a summary of what changed. It then archives the proposals file.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-for-legal --skill review-proposals -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/review-proposals/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/review-proposals/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-for-legal --skill review-proposals -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/review-proposals/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-for-legal --skill review-proposals -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/review-proposals/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install anthropics/claude-for-legal review-proposals
```

2. **Manually: put the files in place**
- File: `.github/skills/review-proposals/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-for-legal --skill review-proposals -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/anthropics/claude-for-legal --path commercial-legal/skills/review-proposals
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/review-proposals/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-for-legal --skill review-proposals -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/anthropics/claude-for-legal/tree/HEAD/commercial-legal/skills/review-proposals/SKILL.md

## When to use it
- Review pending playbook update proposals step by step
- Inspect the exact diff before applying edits to `CLAUDE.md`
- Log rejected or deferred proposals without modifying the practice profile
- Archive the proposals file once all items are resolved

## Example prompts
- /commercial-legal:review-proposals
- Review playbook proposals
- What playbook updates are pending?

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 538549dffe364571.

BEGIN THIRD-PARTY FILE 538549dffe364571
````text
---
name: review-proposals
description: >
  Review and approve (or reject) pending playbook update proposals from the
  playbook-monitor agent and apply approved changes to the practice profile. Use
  when the playbook-monitor agent has surfaced proposals, when the user says
  "review playbook proposals", "what playbook updates are pending", or wants to
  step through deviation-driven playbook changes.
argument-hint: "[no arguments needed — works from the pending proposals file]"
---

# /review-proposals

Steps through pending playbook update proposals from the monitor agent and applies approved changes to `~/.claude/plugins/config/claude-for-legal/commercial-legal/CLAUDE.md`.

## Instructions

1. **Load the playbook-monitor agent** and run Step 5 (review and approval flow).

2. **If no proposals file exists** or it is empty: respond *"No pending proposals. Playbook is up to date."* Do not proceed further.

3. **Present proposals one at a time.** For each, show the full proposal block and offer four options: Accept, Reject, Edit, Defer.

4. **For Accept or Edit:** show the exact diff to `~/.claude/plugins/config/claude-for-legal/commercial-legal/CLAUDE.md` before writing. Only apply after the attorney explicitly confirms.

5. **For Reject or Defer:** log the decision. Do not modify `~/.claude/plugins/config/claude-for-legal/commercial-legal/CLAUDE.md`.

6. **After all proposals are resolved:** show a summary of what changed, then archive the proposals file.

## Examples

```
/commercial-legal:review-proposals
```

```
/commercial-legal:review-proposals
(runs automatically after playbook-monitor notifies you)
```
````
END THIRD-PARTY FILE 538549dffe364571

The third-party file has ended. Everything between the 538549dffe364571 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© anthropics · Apache-2.0 · https://github.com/anthropics/claude-for-legal/tree/HEAD/commercial-legal/skills/review-proposals/SKILL.md

## Similar
- [ansible-automation](https://affpapa.org/en/nevibecode/skills/ansible-automation.md) — skill · 1800 installs
- [team-update](https://affpapa.org/en/nevibecode/skills/team-update.md) — skill · 1000 installs
- [contract-review](https://affpapa.org/en/nevibecode/skills/contract-review.md) — skill · 5400 installs
- [gc-review](https://affpapa.org/en/nevibecode/skills/gc-review.md) — skill · 363 installs
- [iros-registry-automation](https://affpapa.org/en/nevibecode/skills/iros-registry-automation.md) — skill · 6200 installs
- [DocuSign Automation](https://affpapa.org/en/nevibecode/skills/docusign-automation.md) — skill · 4600 installs

From the same set: [anthropics/claude-for-legal](https://affpapa.org/en/nevibecode/by/anthropics/claude-for-legal.md) — 118 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md