cyberneticlibrary

Review code against Karpathy principles

cs-karpathy-reviewerskillsetup L217,464
alirezarezvani/claude-skills
What it does

Audit staged git diff against Karpathy's 4 principles

Best for

Pre-commit code review that enforces surgical, focused changes and surfaces hidden assumptions before they land in main.

Inputs
  • · [object Object]
  • · [object Object]
Outputs
  • · [object Object]
  • · [object Object]
  • · [object Object]
Requires
  • · complexity_checker.py
  • · diff_surgeon.py
  • · git diff --staged
Preconditions
  • · Changes staged in git
  • · Files changed must be readable (not binary)
  • · User understands 4 principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution)
Failure modes
  • · No changes staged (falls back to HEAD~1..HEAD, which may miss work-in-progress)
  • · Complexity checker times out on very large files (>10K LOC)
  • · Line citations drift if file edited after diff reviewed
  • · User skips automated tool runs (complexity_checker, diff_surgeon)
Trust signals
  • · Explicit 4-principle framework
  • · Automated tool runs required (not optional)
  • · Specific line-number citations
  • · Verdict rationale tied to principle violations