Guide · Agent skill
How to use the review-proposals agent skill (Claude)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The review-proposals skill is a Claude agent skill for lawyers who maintain a contract playbook, the standing rules an agent uses when reviewing commercial agreements. It walks you through pending changes that the playbook-monitor agent has suggested, one at a time, so you can accept, reject, edit or defer each one. After reading this guide you will know what the skill does, how to install it, how to trigger it and what it needs before it can run.
Review Playbook Proposalsanthropics/claude-for-legal · Apache-2.0 Download the skill Quick start
- 1Install the skill. Unzip the downloaded ZIP into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 2Confirm the prerequisites. Make sure the claude-for-legal commercial-legal plugin and its playbook-monitor agent are set up, and that a pending proposals file exists.
- 3Ask for pending proposals. Say "review playbook proposals" or run /commercial-legal:review-proposals.
- 4Decide on each proposal. Choose Accept, Reject, Edit or Defer for each item shown one at a time.
- 5Check the diff. For Accept or Edit, read the exact diff to the practice profile before responding.
- 6Confirm the write. Explicitly confirm to apply the change. Reject and Defer leave the file unchanged.
- 7Review the summary. Read the summary of changes once all proposals are resolved. The proposals file is then archived.
What is an agent skill and what does this one do?
An agent skill is a folder containing a SKILL.md file with instructions that Claude follows when a matching request comes in. This skill is named review-proposals and is part of the claude-for-legal commercial-legal plugin.
The playbook-monitor agent watches for repeated deviations from your playbook and suggests changes. This skill presents each proposal, shows an exact diff for any accepted change and writes to your practice profile only after you explicitly confirm. When everything is resolved, it summarises the changes and archives the proposals file.
- Shows the full proposal block for each pending item.
- Offers four options: Accept, Reject, Edit, Defer.
- Rejected and deferred proposals leave the playbook file unchanged.
- Accepted or edited changes are shown as a diff and applied only after confirmation.
Install the review-proposals skill
Download the skill ZIP from this page and unzip it into one of two locations. Use ~/.claude/skills/ to make the skill available to you across projects, or a project's .claude/skills/ folder to limit it to that project.
If you use the Claude apps instead, upload the ZIP under Settings → Capabilities → Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload the ZIP
Meet the requirements before you start
The skill does not work on its own. It needs the claude-for-legal commercial-legal plugin with the playbook-monitor agent set up, because the review flow runs from that agent's Step 5. It also needs a pending proposals file produced by the monitor agent, and write access to the practice profile file.
- claude-for-legal commercial-legal plugin with the playbook-monitor agent (Step 5 review flow)
- A pending proposals file produced by the monitor agent
- Write access to ~/.claude/plugins/config/claude-for-legal/commercial-legal/CLAUDE.md
Trigger the skill with natural requests
You can invoke the skill with a slash command or simply ask in plain language. The source lists these phrases as triggers: "review playbook proposals" and "what playbook updates are pending". You can also ask it to step through deviation-driven playbook changes, or use it after the playbook-monitor agent tells you proposals are waiting.
The skill takes no arguments. It works from the pending proposals file.
- "Review playbook proposals"
- "What playbook updates are pending?"
- "Step me through the deviation-driven playbook changes."
/commercial-legal:review-proposalsWork through proposals and confirm changes
For each proposal, choose Accept, Reject, Edit or Defer. Accept and Edit show you the exact diff to the practice profile before anything is written. Nothing is applied until you explicitly confirm.
Reject and Defer log your decision and leave the practice profile untouched. When all proposals are resolved, the skill shows a summary of what changed and archives the proposals file.
- Accept or Edit: review the diff, then confirm to write the change.
- Reject or Defer: logged, no change to CLAUDE.md.
- If there is nothing pending, the skill replies that the playbook is up to date and stops.
Safety notes: scripts and network
This skill runs no scripts and uses no network access, according to its listing. Its effects are limited to reading the pending proposals file and writing approved changes to the practice profile file.
Approved changes alter how future legal reviews behave. The confirmation step is designed to prevent unreviewed edits, but you should still read each diff carefully before confirming.
- Runs scripts: no
- Uses network: no
- Read each diff before confirming, because approved changes affect future reviews.
What people use it for
- Clearing a batch of deviation-driven playbook suggestions after a period of contract reviews.
- Rejecting a monitor suggestion you disagree with while logging the decision.
- Deferring a proposal that needs further thought before it changes your review rules.
- Editing a suggested rule so the wording matches your firm's standard before it is written.
- Studying how a human-in-the-loop approval step can be built into a Claude skill.
Frequently asked questions
How do I install the review-proposals skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use or a project's .claude/skills/ folder for one project. In the Claude apps, upload the ZIP under Settings → Capabilities → Skills.
Is the review-proposals skill free to use?
The source lists the licence as Apache-2.0 and does not state any price. Check the repository's licence file for terms before you use or redistribute it.
Why does the skill say there are no pending proposals?
It reports nothing pending when no proposals file exists or the file is empty. This usually means the playbook-monitor agent has not produced any proposals yet, so there is nothing to review.
Does the skill change my playbook automatically?
No. Accepted and edited changes are shown as an exact diff and written to the practice profile only after you explicitly confirm. Rejected and deferred proposals do not modify the file.
What do I need before the skill will work?
You need the claude-for-legal commercial-legal plugin with the playbook-monitor agent, a pending proposals file from that agent, and write access to ~/.claude/plugins/config/claude-for-legal/commercial-legal/CLAUDE.md.
Does this skill run scripts or access the internet?
According to its listing, it runs no scripts and uses no network. It works from local files: the proposals file and the practice profile.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are an attorney or in-house legal team using the claude-for-legal commercial plugin and maintain a contract playbook that you want to update only with a human checkpoint. Skip it if you do not have the playbook-monitor agent set up, since there will be no proposals to review, or if you want automatic edits without reading each change.
Download the skill