review-proposals

Review and approve pending playbook update proposals with accept, reject, edit, or defer decisions.

Updated May 15, 2026
One-click install
npx skills add https://github.com/az9713/claude-for-legal-tutorial --skill review-proposals-az9713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-proposals
Source: https://github.com/az9713/claude-for-legal-tutorial/tree/main/commercial-legal/skills/review-proposals
Command: npx skills add https://github.com/az9713/claude-for-legal-tutorial --skill review-proposals-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review and decide whether pending playbook update proposals should be applied, without losing an audit trail or accidentally changing practice profile content without attorney confirmation.

Core Features & Use Cases

  • Proposal-by-proposal approval flow: Presents each pending proposal and guides the user through Accept, Reject, Edit, or Defer decisions.
  • Diff-first change safety: For Accept or Edit, shows the exact diff to the target CLAUDE.md before any write occurs.
  • Change summary and archiving: Produces a resolution summary and archives the proposals file after all items are resolved.
  • No-change logging for declines: Logs Reject/Defer decisions and ensures the target CLAUDE.md is not modified.

Quick Start

Run /commercial-legal:review-proposals to step through all pending playbook update proposals and apply only the changes you explicitly approve.

Frequently Asked Questions about review-proposals

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review and approve playbook updates for a legal practice profile?

Playbook update proposals are reviewed proposal-by-proposal, guiding you through Accept, Reject, Edit, or Defer decisions. Exact diffs to the target CLAUDE.md are shown before any write occurs, ensuring attorney confirmation of all practice profile changes.

What happens to rejected or deferred playbook proposals?

Rejected and deferred playbook proposals are logged as no-change decisions, ensuring the target CLAUDE.md practice profile remains unmodified. This maintains a complete audit trail of all review outcomes without applying unwanted configuration changes.

Can I see a diff before applying pending playbook changes to CLAUDE.md?

Yes, diff-first change safety shows the exact diff to the target CLAUDE.md before any write occurs during the proposal review. This applies to both Accept and Edit decisions, preventing accidental practice profile content changes.

How does the proposal review flow handle missing or empty proposals files?

The proposal review flow enforces a no-proceed behavior when the proposals file is missing or empty. This prevents the approval workflow from starting without valid pending playbook update proposals to evaluate.

What is logged after resolving all pending playbook update proposals?

After resolving all pending proposals, the flow produces a resolution summary and archives the proposals file. This creates an audit-ready record of all accepted, rejected, edited, and deferred decisions for the commercial-legal practice profile.