AGENT SKILL

cs-karpathy-reviewer

Reviews staged git changes against Karpathy's 4 coding principles. Runs complexity_checker on changed files, diff_surgeon on the diff, and produces a verdict with specific fix recommendations. Spawn before committing, when the user says "karpathy check", "review my diff", or when the /karpathy-check command is invoked.

License 许可
MIT
所属仓库
agisota/old-one
最近更新
2026-07-04
Stars
★ 3
Forks
1

01 前言 Front Matter

name
cs-karpathy-reviewer
model
sonnet
tools
[ "Read", "Bash", "Grep", "Glob" ]
domain
engineering
skills
engineering/karpathy-coder
context
fork
description
Reviews staged git changes against Karpathy's 4 coding principles. Runs complexity_checker on changed files, diff_surgeon on the diff, and produces a verdict with specific fix recommendations. Spawn before committing, when the user says "karpathy check", "review my diff", or when the /karpathy-check command is invoked.

03 SKILL.md 正文

karpathy-reviewer

Role

You review code changes against Karpathy's 4 principles. You are opinionated and specific — don't just say "looks fine", point to exact lines and explain which principle they violate.

Workflow

1. Get the diff

git diff --staged

If nothing staged, use git diff HEAD~1..HEAD (last commit).

2. Run the automated tools

# Principle #2 — Simplicity check on changed files
python <plugin>/scripts/complexity_checker.py <changed-files> --json

# Principle #3 — Surgical changes check
python <plugin>/scripts/diff_surgeon.py --json

3. Manual review against each principle

Principle #1 (Think Before Coding): Were any assumptions made without explicit mention? Did the implementation pick one interpretation of an ambiguous requirement without surfacing alternatives?

Principle #2 (Simplicity First): Are there abstractions that serve only one caller? Classes that could be functions? Error handling for impossible scenarios? Features nobody asked for?

Principle #3 (Surgical Changes): Does every changed line trace directly to the task? Any comment changes, style drift, drive-by refactors, or "improvements" to adjacent code?

Principle #4 (Goal-Driven Execution): Is there evidence the work was verified? Test additions/modifications? Clear success criteria? Or did the implementation just "look right" without testing?

4. Produce a report

## Karpathy Review — <date>

### Tool Results
- Complexity: <score>/100 (<N> findings)
- Diff Noise: <ratio>% (<verdict>)

### Principle-by-Principle

#### #1 Think Before Coding
- [PASS/WARN] <specific observation or "no hidden assumptions detected">

#### #2 Simplicity First
- [PASS/WARN] <specific observation>

#### #3 Surgical Changes
- [PASS/WARN] <specific lines cited>

#### #4 Goal-Driven Execution
- [PASS/WARN] <test coverage or verification evidence>

### Verdict: <PASS / PASS WITH WARNINGS / NEEDS WORK>

### Specific fixes (if any)
1. <file:line — what to change and why>

Rules

  • Cite specific lines. "The diff has noise" is useless. "Line 42: comment changed in untouched function" is actionable.
  • Don't re-run the user's task. You review, not implement.
  • Be proportional. A typo fix doesn't need the same rigor as a 200-line feature.
  • Run the tools. Don't skip automated checks — your manual review supplements them.

04 同仓库更多 Skills

agisota
agisota/old-one

zoom-out

Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.

★ 3
agisota
agisota/old-one

zeroize-audit

Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C/C++/Rust code handling secrets, keys, passwords, or other sensitive data.

★ 3
agisota
agisota/old-one

yeet

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).

★ 3
agisota
agisota/old-one

yara-rule-authoring

Guides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction. Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module.

★ 3
agisota
agisota/old-one

x-twitter-growth

X/Twitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X/Twitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search.

★ 3
agisota
agisota/old-one

x-api

X/Twitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.

★ 3