pr-review-extract-lessons

What problem does it solve?

This Skill tackles recurring coding mistakes identified in PR reviews by analyzing patterns across multiple PRs and proposing actionable rules for your project's CLAUDE.md, preventing the same errors from happening again without manual tracking.

Core Features & Use Cases

• Pattern Detection: Groups actionable review threads by root causes like missing error handling or incorrect API usage, filtering for patterns with at least two instances per PR.
• Candidate Tracking: Accumulates patterns in a dedicated file with a 2-PR threshold before promotion, ensuring rules are based on genuine recurrences rather than one-offs.
• Rule Proposal: Drafts broad, actionable rules for CLAUDE.md, seeks user approval before any edits, and handles worktree vs. main repo distinctions for persistent storage.
• Use Case: After completing reviews on several PRs for a Kotlin project, the Skill identifies repeated issues with null checks on hardware resources and proposes a generic rule like "Always null-check return values from methods acquiring hardware resources," which you approve to add to CLAUDE.md for future agent guidance.

Quick Start

Analyze the completed PR review plan in .pr-review/ to extract recurring patterns and propose rules for CLAUDE.md.