CtrlK
BlogDocsLog inGet started
Tessl Logo

andrej-karpathy

Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.

70

Quality

86%

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

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

An exemplary instruction-only skill body: lean, highly actionable behavioral guidance with concrete task transformations, a verifiable-plan template, worked examples, and honest limitations. The only soft spot is that it reads as four principles rather than a strictly sequenced workflow with feedback loops, which is inherent to its nature as behavioral guardrails.

DimensionReasoningScore

Conciseness

The body is lean, imperative bullets ("No features beyond what was asked", "If you write 200 lines and it could be 50, rewrite it") with zero padding and no explanation of concepts Claude already knows, matching 'lean and efficient; every token earns its place'. Not 4 because there is no over-explanation to trim — even the tradeoff and limitations sections earn their place.

5 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: exact task transformations ("'Fix the bug' -> 'Write a test that reproduces it, then make it pass'"), a copy-paste plan template with verify slots, and two worked example responses. This matches the top anchor's 'specific examples cover the common cases'; it is well above the 'mostly executable, minor gaps' level.

5 / 5

Workflow Clarity

The four numbered sections form a coherent order (think -> simplify -> edit surgically -> verify) and section 4 gives explicit validation patterns ("Ensure tests pass before and after", "1. [Step] -> verify: [check]"), matching 'clear sequence with most checkpoints present'. Not 5 because the document is a set of principles rather than a strictly sequenced workflow with error-recovery loops; not 3 because verification checkpoints are explicit, not merely implicit.

4 / 5

Progressive Disclosure

No bundle files exist, and none are needed: the body is a single well-organized file with clear section headers (When to Use, four numbered sections, Examples, Limitations) and no content that belongs in a separate file, satisfying the simple-skill case of 'clear overview... easy navigation'. Not 4 because there are no organization gaps or buried references — the only external link is a clearly-labeled attribution link.

5 / 5

Total

19

/

20

Passed

Description

80%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 and explicitly answers both what the skill does and when to use it, with concrete behavioral actions and an explicit 'Use when' clause in third-person voice. Its main weakness is trigger breadth: 'writing, reviewing, or refactoring code' could match nearly any coding request, creating overlap risk with general code-review and simplification skills.

Suggestions

Narrow the trigger clause to the skill's distinctive purpose, e.g. 'Use when a change risks scope creep, speculative abstractions, or unclear success criteria' rather than all code writing/review/refactoring.

Add natural synonyms users would actually say — 'simplify', 'keep it minimal', 'surgical edit', 'verify the fix' — to improve trigger term coverage.

Consider naming the distinct niche explicitly (e.g. 'LLM coding guardrails derived from Karpathy's guidelines') to reduce conflict with generic code-review or refactoring skills.

DimensionReasoningScore

Specificity

"avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria" lists several specific behavioral actions, matching the 'several specific actions; minor gaps' anchor. Not 5 because the actions are behavioral directives rather than fully concrete capabilities, and not 3 since coverage goes beyond 1-2 actions.

4 / 5

Completeness

"Behavioral guidelines to reduce common LLM coding mistakes" states the what, and "Use when writing, reviewing, or refactoring code to avoid overcomplication..." gives an explicit when with concrete trigger phrases — the exact pattern of the score-5 anchor. Neither half is vague, so 4 is too low.

5 / 5

Trigger Term Quality

"Use when writing, reviewing, or refactoring code" captures natural phrases users say, matching 'good keyword coverage; a few natural terms missing'. Not 5 because common synonyms like 'simplify', 'clean up', or 'keep the change minimal' are absent; not 3 since it includes several natural trigger terms rather than just the domain.

4 / 5

Distinctiveness Conflict Risk

The Karpathy-guidelines framing is somewhat distinct, but the trigger "when writing, reviewing, or refactoring code" is broad enough to fire on virtually any coding task, overlapping with general code-review, refactoring, and simplification skills. Not 4 because the overlap risk extends beyond 'closely related skills'; not 2 because the overcomplication/surgical-changes focus does differentiate it from generic helpers.

3 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
sickn33/agentic-awesome-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.