code-police

Review code changes in three passes for quality, simplicity, and correctness.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/juspay/ci --skill code-police-juspay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-police
Source: https://github.com/juspay/ci/tree/main/.claude/skills/code-police
Command: npx skills add https://github.com/juspay/ci --skill code-police-juspay

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review code for quality, simplicity, and common mistakes before declaring work complete.

Core Features & Use Cases

  • Enforces a structured, three-pass review of changes on the current branch/PR against a defined rule set, including project-specific policies.
  • Highlights issues such as dead code, silent error swallowing, unbounded growth, and inconsistent documentation, guiding maintainability improvements.
  • Encourages using focused libraries over hand-rolled utilities and requires explicit rationale for deviations.

Quick Start

Run the code-police review on the current branch/PR to validate quality, simplicity, and correctness against project rules.

Frequently Asked Questions about code-police

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

FAQPage Schema
How do I enforce coding standards and review code quality before a merge?

You can enforce coding standards by running a structured code review that checks current branch changes for simplicity, correctness, and compliance with project rules. This process highlights dead code, silent error swallowing, and documentation issues to guide maintainability improvements before merge.

What is the best way to detect dead code and silent error swallowing in a pull request?

The best way to detect dead code and silent error swallowing is using a three-pass code review mechanism that analyzes structural integrity, error handling, and maintainability. It identifies these common mistakes and ensures explicit rationale is provided for design decisions.

Can I check my branch against project-specific coding policies automatically?

Yes, you can validate your branch against project-specific coding policies. The review process applies a defined rule set across three passes, checking for unbounded growth and inconsistent documentation to ensure deviations from focused libraries have explicit rationale.

Does structured code review help improve error handling and maintainability?

Structured code review improves error handling and maintainability by guiding reviews through dedicated passes that target structural soundness and explicit rationale. It enforces rules against silent error swallowing and encourages using focused libraries over hand-rolled utilities.

Why should I use a three-pass code review instead of a standard checklist?

A three-pass code review provides deeper analysis than a standard checklist by separately evaluating structure, error handling, and maintainability. This targeted approach effectively catches unbounded growth, dead code, and missing design rationale, ensuring comprehensive quality gate enforcement before merge.

What limitations should I expect when enforcing simplicity and correctness on my current branch?

When enforcing simplicity and correctness, expect limitations related to the scope of the three-pass review, which focuses on code quality, dead code, and error handling. It requires explicit rationale for deviations from focused libraries, meaning complex project-specific architectural rules may need manual validation.