CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

karpathy-coder

Use when writing, reviewing, or committing code to enforce Karpathy's 4 coding principles — surface assumptions before coding, keep it simple, make surgical changes, define verifiable goals. Triggers on "review my diff", "check complexity", "am I overcomplicating this", "karpathy check", "before I commit", or any code quality concern where the LLM might be overcoding.

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured discipline skill: concrete rules with self-tests per principle, executable tooling, clear reference-based disclosure, and sensible 'when to relax' scoping. The consistent weaknesses are moderate — no example script invocations, no explicit end-to-end usage workflow, and a hook reference pointing at a file missing from the bundle.

Suggestions

Add one example invocation per script with real arguments (e.g. 'python scripts/diff_surgeon.py --goal "fix auth bug" main.py') so the tooling is copy-paste ready rather than requiring --help discovery.

Include a short numbered usage sequence — apply principles while coding → run /karpathy-check → fix flagged violations → re-run until clean — to make the end-to-end workflow explicit.

Fix or remove the reference to hooks/karpathy-gate.sh since no hooks/ directory exists in the bundle, or ship the hook file.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — bullets, tables, and per-principle tests with no explanation of known concepts. Minor trimmable material exists: ~10 lines of borrowed Karpathy quotes and the tangential cross-tool compatibility table, keeping it just below the 'every token earns its place' level.

4 / 5

Actionability

Concrete, executable guidance throughout: 'If you write 200 lines and it could be 50, rewrite it', the Instead-of/Transform-to table, a plan template, named scripts with detection scope, the /karpathy-check command, and a pre-commit hook. The gap is that scripts are only reachable via '--help' with no example invocations showing real arguments, so it falls short of fully copy-paste ready.

4 / 5

Workflow Clarity

The plan template embeds verify checkpoints ('1. [Step] → verify: [check]') and Principle 4 defines the loop-until-verified pattern with a test-first transform table; the hook is explicitly non-blocking so no destructive/batch validation cap applies. No explicit end-to-end usage sequence (apply principles → run /karpathy-check → fix → re-run) keeps it below 5.

4 / 5

Progressive Disclosure

The SKILL.md is a lean ~120-line overview with well-signaled, one-level-deep references: all three references/*.md files and all four scripts/*.py files referenced in the body exist and carry one-line descriptions. The dangling reference to hooks/karpathy-gate.sh, which does not exist in the bundle, is the notable organization gap that keeps it from 5.

4 / 5

Total

16

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states what the skill does through four named principles, when to use it via an explicit 'Use when' clause, and lists five natural trigger phrases plus a scoped catch-all. The only weakness is modest overlap risk with general code-review skills from the broad 'any code quality concern' trigger.

DimensionReasoningScore

Specificity

The description enumerates four concrete behaviors — 'surface assumptions before coding, keep it simple, make surgical changes, define verifiable goals' — giving comprehensive, specific coverage of what the skill enforces with no vague filler.

5 / 5

Completeness

It explicitly answers both questions with concrete triggers: what ('enforce Karpathy's 4 coding principles...') and when ('Use when writing, reviewing, or committing code' followed by 'Triggers on...'), structurally matching the 5 anchor example.

5 / 5

Trigger Term Quality

Natural user phrases are comprehensively covered: 'review my diff', 'check complexity', 'am I overcomplicating this', 'karpathy check', 'before I commit', plus the catch-all 'any code quality concern where the LLM might be overcoding'. These match what a user would actually say, exceeding the 'a few natural terms missing' level of score 4.

5 / 5

Distinctiveness Conflict Risk

The niche is distinct (Karpathy's 4 principles, LLM-specific overcoding pitfalls) with unique triggers like 'karpathy check' and 'am I overcomplicating this'. However 'any code quality concern' and 'reviewing code' create minor overlap risk with general code-review skills, fitting the 'mostly distinct; minor overlap' anchor rather than the minimal-conflict level of 5.

4 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

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

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.