Home / hashgraph-online / awesome-codex-plugins · GitHub

karpathy-guidelines SKILL.md skillA

karpathy-guidelines from hashgraph-online/awesome-codex-plugins is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add hashgraph-online/awesome-codex-plugins/karpathy-guidelines@git:20260512.6523792

Pins git:20260512.6523792 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: hashgraph-online/awesome-codex-plugins
Path: plugins/Colin4k1024/tsp/skills/karpathy-guidelines/SKILL.md
Versions recorded: 1
Latest version: git:20260512.6523792, committed May 12, 2026
Size: 3,159 bytes
Repository stars: 1,501
License: Apache-2.0

提供一组面向编码行为的轻量约束，帮助代理在动手前暴露假设、优先简单方案、保持改动外科化，并把任务改写成可验证目标。当任务容易被误解、过度设计、顺手扩散改动，或需要先锁定成功标准时使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Karpathy Guidelines

基于 [`Colin4k1024/andrej-karpathy-skills`](https://github.com/Colin4k1024/andrej-karpathy-skills/tree/main) 的方法论做本地化吸收，用来降低代理在真实代码库里常见的三类失误：替用户做错假设、把实现做重、顺手改到不该碰的地方。

这不是新的编码规范、TDD 或验收框架，而是一层更前置的行为护栏：

- 需要代码风格、命名、通用工程规范时，接 [coding-standards](../coding-standards/SKILL.md)
- 需要测试先行与 RED/GREEN/REFACTOR 时，接 [tdd-workflow](../tdd-workflow/SKILL.md)
- 需要在收尾前给出构建、测试、校验证据时，接 [verification-loop](../verification-loop/SKILL.md)

## 用途

- 把“先理解再动手”变成默认动作，而不是出错后的补救。
- 把“能跑就行”的实现收敛成最小可交付方案，减少过度抽象和未来感设计。
- 把改动边界钉住，避免为了解一个问题顺手重写一片上下文。
- 把含糊任务改写成可验证结果，方便后续接 TDD、验证循环和 handoff。

## 默认做法

1. **Think Before Coding**：先写清当前理解、关键假设、歧义点和更简单备选，不在有歧义时静默选一种解释。
2. **Simplicity First**：只做当前需求闭环所需的最小实现；不要为“以后可能用到”先铺抽象、配置层或扩展点。
3. **Surgical Changes**：只改与当前请求直接相关的文件和代码；如果发现无关坏味道，只记录，不顺手清理。
4. **Goal-Driven Execution**：把“做某件事”改写成“达到什么可验证结果”；优先使用测试、命令输出或明确检查项作为成功标准。

## 触发信号

- 用户目标清楚，但实现解释不止一种，容易靠猜测直接开写。
- 任务范围小，却很容易被做成一层新抽象、框架或配置系统。
- 仓库已有稳定模式，改动只应触及局部逻辑，不应连带整理周边代码。
- 需求里出现“修一下”“加一下”“支持一下”这类宽泛表述，需要先收敛成功条件。
- 开始编码前需要决定：先问清楚、先补测试、还是先做最小实现。

## 配套约束

1. 这是一层前置行为约束，不替代具体实现 skill；进入编码后仍应接对应语言/框架 skill。
2. 一旦决定实现新行为或修复缺陷，继续按 [tdd-workflow](../tdd-workflow/SKILL.md) 走测试先行。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add hashgraph-online/awesome-codex-plugins/karpathy-guidelines@sha256:c060a46cf8bede34

The line at the top of this page pins the label git:20260512.6523792, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

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

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 12, 2026.

version	committed	commit	size	audit
git:20260512.6523792 latest	2026-05-12	6523792	3,159 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the 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 (3159 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

hashgraph-online/awesome-codex-plugins · 1,501 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5wf3vimrbwbhfrdw
GET https://markdownregistry.com/api/v1/resolve?ref=hashgraph-online/awesome-codex-plugins/karpathy-guidelines
GET https://markdownregistry.com/api/v1/blob/c060a46cf8bede344fade32698c7889f689ac73076d4d80c313c71ec1ad9ffbc

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from hashgraph-online/awesome-codex-plugins

AGENTS.md AGENTS.md file

hashgraph-online/awesome-codex-plugins · AGENTS.md

git:20261103.f1993d0 · audit A · 1,501 stars

ontoly-software-graph SKILL.md skill

hashgraph-online/awesome-codex-plugins · plugins/0xsarwagya/ontoly-codex-plugin/skills/ontoly-software-graph/SKILL.md · Use Ontoly Software Graph evidence, CLI reports, MCP, and official Ontoly Agent Skills before searching source files…

git:20260714.2040a1b · audit A · 1,501 stars

agent-debug-fixer SKILL.md skill

hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-debug-fixer/SKILL.md · 中文调试修复技能。用于报错、测试失败、页面异常、功能不符合预期、需要定位根因并做最小修复时。触发语包括"进入调试模式""帮我修问题""报错了""测试失败""页面坏了""找根因"。