Content
71%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, disciplined instruction body with concrete rules, tests, and templates that mostly earns its tokens. Its main defect is that the entire advertised bundle — three reference docs, four Python tools, and a pre-commit hook — is absent, so the progressive-disclosure structure is aspirational rather than real and the deferred examples are unreachable.
Suggestions
Ship the advertised bundle files (references/karpathy-principles.md, references/anti-patterns.md, references/enforcement-patterns.md, the four scripts/*.py, and hooks/karpathy-gate.sh) or remove the sections that reference them, so the References/Python-tools/pre-commit-hook navigation is not dangling.
Add one worked before/after code example inline (e.g., a 50-line vs 15-line diff) so actionability does not depend on the missing references/anti-patterns.md.
Sequence the review workflow explicitly — e.g., number the steps of a /karpathy-check pass (assumptions → complexity → diff noise → goal verification) with what to do when a check fails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — bullet rules, tables, and short sections with no explanation of concepts Claude already knows — but the three verbatim Karpathy blockquotes substantially duplicate the four-principles section that follows and could be trimmed to one. Fits 'efficient; minor instances of over-explanation that could be trimmed' rather than 5, and is far from the padded verbosity of 2. | 4 / 5 |
Actionability | Concrete guidance throughout: per-principle rules, a vague→verifiable transformation table ('Write tests for invalid inputs, then make them pass'), a plan template with verify steps, and a per-script detection table. Not 5 because no worked before/after example is inline — examples are deferred to references/anti-patterns.md, and the scripts are only described, never invoked with actual commands. | 4 / 5 |
Workflow Clarity | Each principle carries an explicit validation test ('The test: Every changed line should trace directly to the user's request') and the plan format embeds '→ verify: [check]' checkpoints, giving most checkpoints. Not 5 because the overall review flow is never sequenced — '/karpathy-check — Run the full 4-principle review' is one line with no step order or error-recovery loop. | 4 / 5 |
Progressive Disclosure | In-body organization is good — well-labeled sections and a clearly signaled References list one level deep — but every advertised bundle path is missing from the skill: no references/, scripts/, or hooks/ exist, so references/karpathy-principles.md, anti-patterns.md, enforcement-patterns.md, the four scripts/*.py, and hooks/karpathy-gate.sh are all dangling. The structure question's navigation promise is broken, which offsets the otherwise good signaling. | 3 / 5 |
Total | 15 / 20 Passed |