CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

70

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

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

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.

The content is well-organized and actionable with lean prose and a clear goal-driven workflow, scoring consistently at 4 across dimensions. The main gap is that several referenced bundle files (scripts, references, hooks) are advertised but absent, which weakens progressive disclosure.

Suggestions

Ship the referenced bundle files (references/karpathy-principles.md, references/anti-patterns.md, references/enforcement-patterns.md, scripts/*.py, hooks/karpathy-gate.sh) so the documented navigation resolves, or remove references to files that do not exist.

Inline at least one short executable example (e.g. a sample complexity_checker.py invocation and its output) so the body is copy-paste ready without relying on external --help.

Add an explicit validate->fix->retry loop to the main /karpathy-check review workflow rather than only to the per-task plan template.

DimensionReasoningScore

Conciseness

The body is lean—bullet principles, compact tables, minimal prose—and avoids explaining concepts Claude already knows, but the multi-line Karpathy quote block and the supplementary cross-tool/related-skills sections add length that could be trimmed. Not 5 because some sections are supplementary rather than strictly necessary; not 3 because there is no real padding.

4 / 5

Actionability

Provides concrete commands (/karpathy-check, --help), a tools table stating what each detects, the hook wiring path, and a plan template with verify checks, but contains no inline copy-paste code sample since the scripts live externally. Not 5 because it relies on external --help rather than inline executable examples; not 3 because the guidance is mostly executable and concrete.

4 / 5

Workflow Clarity

The goal-driven section gives an "Instead of -> Transform to" table and a numbered plan template with a verify checkpoint per step, but the main review flow (/karpathy-check -> sub-agent -> tools) is described at a high level without an explicit validate->fix->retry error-recovery loop. Not 5 because the primary workflow lacks explicit recovery checkpoints; not 3 because checkpoints are present via the plan template.

4 / 5

Progressive Disclosure

The body is well-structured with a clearly signaled References section and a scripts table pointing one level deep to references/*.md, scripts/*.py, and hooks/*.sh, but the referenced bundle files (e.g. references/anti-patterns.md, complexity_checker.py) do not exist on disk, so the claimed navigation does not resolve. Not 5 because the promised references are missing; not 3 because the written structure is genuinely well-organized rather than inline-dumped.

4 / 5

Total

16

/

20

Passed

Description

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

The description is exemplary: it states concrete capabilities, includes natural trigger phrases, explicitly covers both what and when, and carves out a distinct niche with low conflict risk. No improvements needed.

DimensionReasoningScore

Specificity

Names four concrete principles ("surface assumptions before coding, keep it simple, make surgical changes, define verifiable goals") plus concrete actions ("writing, reviewing, or committing code"), matching the anchor for multiple specific concrete actions with comprehensive coverage.

5 / 5

Completeness

Explicitly answers "what" ("enforce Karpathy's 4 coding principles...") and "when" ("Triggers on..." with concrete trigger phrases), matching the anchor for clearly answering both what and when with concrete triggers.

5 / 5

Trigger Term Quality

Quotes five natural phrases a user would say ("review my diff", "check complexity", "am I overcomplicating this", "karpathy check", "before I commit") plus "code quality concern where the LLM might be overcoding", giving comprehensive natural-term coverage including synonyms.

5 / 5

Distinctiveness Conflict Risk

Tied to a clear niche ("Karpathy's 4 coding principles", "where the LLM might be overcoding") with distinct triggers, giving minimal conflict risk with other skills.

5 / 5

Total

20

/

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.

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