Home / jnpiyush / agentx · .github/skills/development/karpathy-guidelines/SKILL.md · GitHub

karpathy-guidelines skillA

karpathy-guidelines is agent-read markdown (skill) from jnpiyush/agentx: 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. Adapted from Andrej Karpathy's observations on LLM coding pitfalls..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Karpathy Guidelines

Behavioral guidelines to reduce common LLM coding mistakes. Adapted from
[Andrej Karpathy's observations](https://x.com/karpathy/status/2015883857489522876)
on LLM coding pitfalls and the upstream MIT-licensed
[karpathy-guidelines skill](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/skills/karpathy-guidelines/SKILL.md).

> **MANDATORY in Frontier**: These four guidelines are NON-optional for every
> Frontier execution (coding, refactor, review, pipeline). Complete the
> "Self-Check Before Handoff" checklist before any handoff. See the always-on
> rule in `.github/instructions/project-conventions.instructions.md`.

**Tradeoff:** These guidelines bias toward caution over speed. The only
exemption is a genuinely trivial change (single-line typo, obvious config
rename) whose success criteria are self-evident.

## When to Use

Load this skill when:

- Writing new code or features
- Refactoring or modifying existing code
- Reviewing code (yours or another agent''s)
- Debugging when the cause is not obvious
- Producing pipelines, IaC, or any artifact that ships to production
…

Read the whole file at its exact version.

How to install

Latest version
mdr add jnpiyush/agentx/karpathy-guidelines@git:20260915.f17c505
Exact content
mdr add jnpiyush/agentx/karpathy-guidelines@sha256:6088806bd4286c42

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_zd5fxnazgbklisv6.svg)](https://markdownregistry.com/a/art_zd5fxnazgbklisv6)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260915.f17c505 latest2026-09-15 f17c505 8,624 BA view · diff
git:20260903.b3f26102026-09-03 b3f2610 8,608 BA view · diff
git:20260530.55f71372026-05-30 55f7137 8,586 BA view · diff
git:20260517.4703a792026-05-17 4703a79 8,183 BA view · diff
git:20260418.25fe4862026-04-18 25fe486 6,674 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8624 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jnpiyush/agentx · 16 stars · license Apache-2.0 · pushed 2026-09-21 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_zd5fxnazgbklisv6
GET https://markdownregistry.com/api/v1/resolve?ref=jnpiyush/agentx/karpathy-guidelines
GET https://markdownregistry.com/api/v1/blob/6088806bd4286c4276ebb2b124ab8d46890386d03b7b6e081f657691289ee1e9

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from jnpiyush/agentx

000-frontier-core rules
jnpiyush/agentx · .cursor/rules/000-frontier-core.mdc · Frontier core operating contract for Cursor. Always applied.
git:20260915.f17c505 · audit A · 16 stars
ai rules
jnpiyush/agentx · .cursor/rules/ai.mdc · AI / agent / LLM workflow standards (Frontier)
git:20260915.f17c505 · audit A · 16 stars
csharp rules
jnpiyush/agentx · .cursor/rules/csharp.mdc · C# / .NET coding standards (Frontier)
git:20260915.f17c505 · audit A · 16 stars
python rules
jnpiyush/agentx · .cursor/rules/python.mdc · Python coding standards (Frontier)
git:20260915.f17c505 · audit A · 16 stars
react rules
jnpiyush/agentx · .cursor/rules/react.mdc · React / TSX frontend standards (Frontier)
git:20260915.f17c505 · audit A · 16 stars
typescript rules
jnpiyush/agentx · .cursor/rules/typescript.mdc · TypeScript / Node backend standards (Frontier)
git:20260915.f17c505 · audit A · 16 stars
agent-memory-systems skill
jnpiyush/agentx · .github/skills/ai-systems/agent-memory-systems/SKILL.md · Design agent memory beyond a single context window: short-term (working / scratchpad), long-term (episodic, semantic…
v1.0.0 · audit A · 16 stars
agent-observability skill
jnpiyush/agentx · .github/skills/ai-systems/agent-observability/SKILL.md · Instrument LLM agents with tracing, metrics, and evaluation telemetry. Use when adding OpenTelemetry GenAI semantic…
v1.0.0 · audit A · 16 stars
ai-agent-development skill
jnpiyush/agentx · .github/skills/ai-systems/ai-agent-development/SKILL.md · Build production-ready AI agents with Microsoft Foundry and Agent Framework. Use when creating AI agents, selecting LLM…
git:20260903.b3f2610 · audit A · 16 stars
ai-evaluation skill
jnpiyush/agentx · .github/skills/ai-systems/ai-evaluation/SKILL.md · Use when evaluating AI quality, safety, completeness and cost with held-out tasks, executable graders, calibrated…
v1.1.0 · audit A · 16 stars
ai-safety-and-red-teaming skill
jnpiyush/agentx · .github/skills/ai-systems/ai-safety-and-red-teaming/SKILL.md · Defend LLM systems against prompt injection, jailbreaks, data exfiltration, and unsafe output. Covers input/output…
v1.0.0 · audit B · 16 stars
anthropic-claude skill
jnpiyush/agentx · .github/skills/ai-systems/anthropic-claude/SKILL.md · Implement production applications with Anthropic Claude models -- Messages API, tool use, prompt caching, extended…
v1.0.0 · audit A · 16 stars

Every file in jnpiyush/agentx

Other files named karpathy-guidelines

karpathy-guidelines skill
hashgraph-online/awesome-codex-plugins · plugins/Colin4k1024/tsp/skills/karpathy-guidelines/SKILL.md · 提供一组面向编码行为的轻量约束,帮助代理在动手前暴露假设、优先简单方案、保持改动外科化,并把任务改写成可验证目标。 当任务容易被误解、过度设计、顺手扩散改动,或需要先锁定成功标准时使用。
git:20260512.6523792 · audit A · 1,074 stars
karpathy-guidelines skill
mxyhi/ok-skills · karpathy-guidelines/SKILL.md · Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid…
git:20260508.0cab7e8 · audit A · 490 stars
karpathy-guidelines skill
coco-research/coco · skills/karpathy-guidelines/SKILL.md · Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid…
git:20260802.1479e32 · audit A · 478 stars
karpathy-guidelines skill
cowork-os/cowork-os · resources/skills/karpathy-guidelines/SKILL.md · Surgical execution guardrails for coding, debugging, review, and refactor tasks
v1.0.0 · audit A · 459 stars
karpathy-guidelines skill
openyida/openyida · .agents/skills/karpathy-guidelines/SKILL.md · Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid…
git:20260728.2c22517 · audit A · 217 stars
karpathy-guidelines skill
youdotcom-oss/agent-skills · .agents/skills/karpathy-guidelines/SKILL.md · Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid…
git:20260723.e470633 · audit A · 78 stars
karpathy-guidelines skill
index-login/mobilere-skill · .kilo/skill/karpathy-guidelines/SKILL.md · 减少 LLM 常见编码错误的行为准则。在编写、审查或重构代码时使用,避免过度设计、精准修改、暴露假设、定义可验证的成功标准。
git:20260803.71f8be9 · audit A · 54 stars
karpathy-guidelines skill
jjmartres/ai-coding-agents · shared/.ai-agents/skills/karpathy-guidelines/SKILL.md · Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid…
git:20260428.dfccef3 · audit A · 48 stars

Browse by kind, by grade A, or by owner.