AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

karpathy-check

Run Karpathy's 4-principle review on staged changes or the last commit. Checks complexity, diff noise, hidden assumptions, and goal verification. Usage /karpathy-check [--last-commit]

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--karpathy-check at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 1

SKILL.md

/karpathy-check

Review your staged changes (or last commit) against Karpathy's 4 coding principles.

Usage

/karpathy-check                 # review staged changes
/karpathy-check --last-commit   # review the most recent commit

What it runs

  1. Principle #2 (Simplicity): engineering/karpathy-coder/skills/karpathy-coder/scripts/complexity_checker.py on all changed files — detects over-engineering, premature abstractions, deep nesting, long functions
  2. Principle #3 (Surgical): engineering/karpathy-coder/skills/karpathy-coder/scripts/diff_surgeon.py on the diff — detects comment-only changes, whitespace noise, style drift, drive-by refactors
  3. Principles #1 + #4 (Think + Goals): The karpathy-reviewer agent reads the diff and applies human-judgment checks — hidden assumptions, missing verification

Output

A structured report with per-principle verdicts and specific line-level fix recommendations.

When to run

  • Before committing (catches noise and overcomplication early)
  • After completing a feature (sanity check before PR)
  • When you suspect the LLM overcoded something

Sub-agent

Dispatches the karpathy-reviewer agent. See agents/karpathy-reviewer.md.

Scripts

  • engineering/karpathy-coder/skills/karpathy-coder/scripts/complexity_checker.py
  • engineering/karpathy-coder/skills/karpathy-coder/scripts/diff_surgeon.py
  • engineering/karpathy-coder/skills/karpathy-coder/scripts/assumption_linter.py
  • engineering/karpathy-coder/skills/karpathy-coder/scripts/goal_verifier.py

Skill Reference

→ engineering/karpathy-coder/skills/karpathy-coder/SKILL.md