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.

66

Quality

83%

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

The canonical home for this skill is karpathy-coder in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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-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.

DimensionReasoningScore

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

Description

91%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.

A strong description that clearly states what it does (enforce the 4 Karpathy principles) and when to use it, with an excellent set of natural trigger phrases. Its only weakness is moderate overlap with general code-review skills on 'review my diff'/'before I commit' triggers and a broad 'any code quality concern' catch-all.

DimensionReasoningScore

Specificity

'surface assumptions before coding, keep it simple, make surgical changes, define verifiable goals' lists several specific concrete actions tied to the writing/reviewing/committing domain. Not 5 because the actions are principle labels rather than literal capabilities (what the detection tools actually do is never stated); well above the 1–2 concrete actions of anchor 3.

4 / 5

Completeness

Explicitly answers both: what — 'enforce Karpathy's 4 coding principles — surface assumptions before coding, keep it simple, make surgical changes, define verifiable goals' — and when — 'Use when writing, reviewing, or committing code' plus a concrete 'Triggers on...' phrase list. Exactly the both-what-and-when-with-concrete-triggers anchor.

5 / 5

Trigger Term Quality

'review my diff', 'check complexity', 'am I overcomplicating this', 'karpathy check', 'before I commit', and 'overcoding' are natural phrases users would actually say, covering multiple synonyms of the skill's purpose. Matches the comprehensive-natural-terms anchor.

5 / 5

Distinctiveness Conflict Risk

The Karpathy/overcoding niche with 'am I overcomplicating this' and 'karpathy check' is distinct, but 'review my diff' and 'before I commit' would also naturally trigger generic code-review and commit-message skills, and 'any code quality concern' is a broad catch-all. Minor overlap with closely related skills — anchor 4, not the minimal-conflict 5.

4 / 5

Total

18

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/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.