review-proposals — Claude Code skill: what it does, how to install
Steps through pending playbook update proposals from the playbook-monitor agent and applies approved changes to the practice profile.
npx skills add anthropics/claude-for-legal --skill review-proposals -a claude-codeWhat review-proposals 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.
What it helps with
- 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 for the agent
- /commercial-legal:review-proposals
- Review playbook proposals
- What playbook updates are pending?
How to install review-proposals
1Skills CLI (Vercel)
npx skills add anthropics/claude-for-legal --skill review-proposals -a claude-code2Manually: put the files in place
~/.claude/skills/review-proposals/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/review-proposals/
1Skills CLI (Vercel)
npx skills add anthropics/claude-for-legal --skill review-proposals -a codex2Manually: put the files in place
.agents/skills/review-proposals/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add anthropics/claude-for-legal --skill review-proposals -a cursor2Manually: put the files in place
.cursor/skills/review-proposals/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install anthropics/claude-for-legal review-proposals2Manually: put the files in place
.github/skills/review-proposals/SKILL.md1Skills CLI (Vercel)
npx skills add anthropics/claude-for-legal --skill review-proposals -a gemini-cli2Platform CLI
gemini skills install https://github.com/anthropics/claude-for-legal --path commercial-legal/skills/review-proposalsManually: put the files in place
.devin/skills/review-proposals/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add anthropics/claude-for-legal --skill review-proposals -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about review-proposals
How do I install review-proposals in Claude Code?
Run npx skills add anthropics/claude-for-legal --skill review-proposals -a claude-code in your terminal.
What does the review-proposals skill do?
It steps through pending playbook update proposals from the playbook-monitor agent one by one. You can choose Accept, Reject, Edit, or Defer, with approved changes applied to the practice profile.
Are playbook changes applied automatically?
No, changes are never written without explicit attorney confirmation. For Accept or Edit decisions, the skill shows the exact diff to ~/.claude/plugins/config/claude-for-legal/commercial-legal/CLAUDE.md and waits for approval.
Source text
SKILL.md · Apache-2.0
--- 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) ```
© anthropics · Apache-2.0 · anthropics/claude-for-legal