Agent skill

code-review

Perform iterative code review using the Rule of 5 methodology - five stages of refinement focusing on structure, correctness, clarity, edge cases, and production readiness.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/code-review-charly-vibes-wai-3

SKILL.md

Iterative Code Review with Rule of 5

I need you to review this code using the Rule of 5 - five stages of iterative refinement.

CODE TO REVIEW: [paste your code or specify file path]

PHILOSOPHY: "Breadth-first exploration, then editorial passes"

STAGE 1: DRAFT - Get the shape right Question: Is the overall approach sound? Focus:

  • Don't aim for perfection
  • Review overall structure and approach
  • Identify major architectural issues
  • Get the "shape" right before refining details
  • Is this solving the right problem?

Output: High-level assessment, major structural issues

STAGE 2: CORRECTNESS - Is the logic sound? Question: Are there errors, bugs, or logical flaws? Focus:

  • Fix errors and bugs identified in Stage 1
  • Verify logical correctness
  • Check algorithms and data structures
  • Ensure functions do what they claim
  • Identify off-by-one errors, wrong operators, etc.

Output: List of correctness issues with locations

STAGE 3: CLARITY - Can someone else understand this? Question: Is the code comprehensible? Focus:

  • Improve readability based on Stage 2 fixes
  • Remove or explain technical jargon
  • Clarify variable and function names
  • Improve code organization
  • Add comments where intent isn't obvious

Output: Clarity improvements and naming suggestions

STAGE 4: EDGE CASES - What could go wrong? Question: Are boundary conditions handled? Focus:

  • Identify gaps from previous stages
  • Handle unusual scenarios
  • Check boundary conditions (null, empty, max values)
  • Error handling for external dependencies
  • Input validation gaps

Output: Edge cases and error handling issues

STAGE 5: EXCELLENCE - Ready to ship? Question: Would you be proud to ship this? Focus:

  • Final polish based on all previous stages
  • Production quality check
  • Performance considerations
  • Documentation completeness
  • Overall code quality

Output: Final recommendations for production readiness

CONVERGENCE CHECK: After each stage (starting with Stage 2), report:

  1. Number of new CRITICAL issues found
  2. Number of new issues vs previous stage
  3. Convergence status:
    • CONVERGED: No new CRITICAL, <10% new issues
    • CONTINUE: Proceed to next stage
    • NEEDS_HUMAN: Found blocking issues requiring judgment

FINAL REPORT:

  • Total issues by severity
  • Top 3 most critical findings
  • Recommended next actions
  • Production readiness assessment

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results