Один файл на 2,3 КБ, 224 тысячи звёзд на GitHub и четыре правила, которые снимают самые дорогие привычки агентов: молчаливые допущения, переусложнение и правки «заодно».
Репозиторий multica-ai/andrej-karpathy-skills — это один файл CLAUDE.md на 2 357 байт с четырьмя принципами, собранными из публичных наблюдений Андрея Карпати об ошибках LLM в коде. К 26.10.2026 у него 224 467 звёзд и 22 459 форков — больше, чем у большинства Agent Skills вместе взятых. Ниже — что именно написано в файле, как его подключить в Claude Code, Cursor и другие агенты, и как проверить, что он действительно работает.
Важно с самого начала: это не навык с инструментами и не плагин с кодом. Это текстовые правила поведения, которые агент читает в начале сессии. Эффект достигается не магией, а тем, что агент перестаёт молча выбирать интерпретацию задачи и начинает её проговаривать.
Исходный тезис автора проекта — четыре наблюдения о поведении моделей в коде. Первое: модель делает неверные допущения «за вас» и спокойно идёт дальше, не проверяя их, не задавая вопросов и не показывая развилки. Второе: она любит усложнять — плодит абстракции, конфигурируемость, обработку невозможных сценариев и пишет тысячу строк там, где хватило бы сотни. Третье: она меняет и удаляет код и комментарии, которые не понимает, даже если это не относится к задаче. Четвёртое: она плохо работает с размытыми критериями успеха.
Каждой из этих привычек в файле противопоставлен принцип. Логика простая: если агенту дать явные критерии проверки, он будет крутиться в цикле до их выполнения — это как раз то, в чём модели сильны. Если критериев нет, он останавливается там, где решил, что «выглядит нормально».
| Принцип | Против чего | Как звучит в файле |
|---|---|---|
| Think Before Coding | молчаливые допущения, скрытая путаница | «Не предполагай. Не скрывай непонимание. Показывай развилки» |
| Simplicity First | переусложнение, раздутые абстракции | «Минимум кода. Ничего спекулятивного» |
| Surgical Changes | правки «заодно», удаление чужого кода | «Трогай только то, что должен. Убирай только свой мусор» |
| Goal-Driven Execution | размытые критерии, работа «на глаз» | «Определи критерии успеха. Повторяй, пока не проверено» |
Файлы в репозитории разложены по хостам: CLAUDE.md для Claude Code, skills/karpathy-guidelines/SKILL.md для Agent Skills, .cursor/rules/karpathy-guidelines.mdc для Cursor и манифест плагина в .claude-plugin/. Все четыре версии несут один и тот же текст правил, отличаются только обёрткой и способом установки.
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
forrestchang/andrej-karpathy-skills, а сам репозиторий живёт как multica-ai/andrej-karpathy-skills. Старый путь пока отвечает редиректом (проверено 26.10.2026), но при установке из маркетплейса надёжнее брать текущее имя — иначе рано или поздно получите 404.curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md
cat karpathy.md >> CLAUDE.md
grep -c '^## ' CLAUDE.md
Третий способ — скилл: скопируйте каталог skills/karpathy-guidelines в свой набор навыков, если хост поддерживает формат Agent Skills (папка + SKILL.md с frontmatter). Четвёртый — правило Cursor: файл .cursor/rules/karpathy-guidelines.mdc уже лежит в репозитории, его можно перенести в свой проект или подключить как глобальное правило. Подробности — в CURSOR.md репозитория.
Файл короткий, и это его сильная сторона: правила читаются за минуту и не размываются. Ниже — суть каждого раздела с практическим переводом на язык задач.
## 1. Think Before Coding - State your assumptions explicitly. If uncertain, ask. - If multiple interpretations exist, present them. - If a simpler approach exists, say so. ## 2. Simplicity First - No features beyond what was asked. - No abstractions for single-use code. - If 200 lines could be 50, rewrite it.
| Симптом в диффе | Какой принцип сработал | Что делать |
|---|---|---|
| Появились файлы и абстракции, о которых не просили | Simplicity First | вернуть задачу с явным ограничением объёма |
| Агент переформатировал соседний код | Surgical Changes | попросить дифф только по своей задаче |
| Правка сделана без вопросов и «как понял» | Think Before Coding | требовать список допущений до кода |
| Непонятно, закончена ли задача | Goal-Driven Execution | задать критерий: какой тест должен пройти |
Отдельный раздел README — «как понять, что работает». Признаки: в диффах меньше лишних изменений, меньше переписываний из-за переусложнения, уточняющие вопросы приходят до реализации, а не после ошибки, и в пул-реквестах нет «попутных улучшений». Если ни один из признаков не появился за неделю, файл, скорее всего, просто игнорируется хостом — проверьте, что он реально загружается в контекст.
По звёздам karpathy-skills — крупнейший текстовый набор правил для агентов: 224 467 звёзд против 48 327 у cloudflare/security-audit-skill и 33 178 у anthropics/knowledge-work-plugins. Но звёзды здесь означают не качество кода, а узнаваемость идеи: файл крошечный, форкают его массово и адаптируют под свои проекты.
Разница в метриках объясняет и разницу в природе проектов. karpathy-skills — это 2,3 КБ текста, который копируют в проект целиком; claude-seo и security-audit-skill — многофайловые наборы с поднавыками, скриптами и собственными процедурами. Поэтому у них форков на тысячу звёзд больше: их не «звёздят на будущее», а сразу забирают в работу.