Andrej Karpathy Skills とは？Karpathy の観察に基づく Claude Code 行動指針

Andrej Karpathy skills の概要を解説。LLM コーディングの落とし穴に関する Karpathy の観察に基づく、Claude Code 向け CLAUDE.md ルールセット。4 つの原則、そのまま使えるインストールコマンド、FAQ をまとめました。

最終更新: 2026-10-31

Andrej Karpathy skills とは？

「Andrej Karpathy skills」はプロジェクトの通称で、README 上の正式タイトルは Karpathy-Inspired Claude Code Guidelines です。実体は 1 つの CLAUDE.md ファイルで、Andrej Karpathy が公開した「LLM コーディングエージェントは実際どのように失敗するか」という観察に基づいて、Claude Code の挙動を改善するために作られています。このプロジェクトは多くの開発者の痛髪を突きました —— リポジトリは GitHub スター 22万7,000 を超えており、それが説明されている失敗パターンに心当たりがある開発者の多さを物語っています。

Karpathy の投稿（README からリンクされています）が名指しした問題は 3 つあります。

「モデルはユーザーの代わりに誤った仮定を置き、確認もせずにそのまま突き進みます。自分の混乱を管理せず、明確化を求めず、矛盾を表面化させず、トレードオフを提示せず、反論すべき時に反論しません。」

「コードや API を過度に複雑にするのが大好きで、抽象を膨らませ、デッドコードを片付けません……100 行で済むところを 1000 行の肥大化した構造として実装します。」

「タスクと無関係なはずのコメントやコードを、十分に理解していないまま副作用として変更・削除することが、今でもあります。」

一点はっきりさせておくと、プロジェクト自体はコミュニティ製です。Karpathy 本人がリリースしたものではなく、README の作者（Multica —— 再利用可能なスキルでコーディングエージェントを実行・管理するオープンソースプラットフォーム —— の作者でもあります）が、Karpathy の公開観察を実務で使えるルールセットに整理しました。ライセンスは MIT です。

このディレクトリの読者への位置づけの説明：これは Claude Code プラグイン / CLAUDE.md ファイルであり、DeepSeek Harness（dsh）ネイティブのプラグインではありません。それでも読む価値はあります。 encode されている 4 つの原則は、どのような LLM コーディングエージェントにも適用できるからです。dsh も例外ではありません。

どのルールを定めているのか？

1 つのファイルに 4 つの原則があり、それぞれが上記の失敗パターンに直接対応します。

1. 書く前に考える（Think Before Coding）

仮定を置かない。混乱を隠さない。トレードオフを提示する。

仮定は明示する —— 曖昧なら推測ではなく質問する
解釈が複数あり得るなら複数提示する —— 曖昧なまま黙って選ばない
反論すべき時は反論する —— よりシンプルな手法があるなら言う
混乱したら止まる —— 何が不明確かを名指して明確化を求める

2. シンプル第一（Simplicity First）

問題を解決するのに必要な最小限のコード。先走ったものは何も入れない。

依頼されていない機能を追加しない
一度きりの使い捨てコードに抽象化を導入しない
依頼されていない「柔軟性」や「設定可能性」を加えない
起こり得ないシナリオのためのエラー処理を書かない
200 行で書けるものが 50 行で済むなら、書き直す

README の検証基準：シニアエンジニアが「これは複雑すぎる」と言うか？言うなら、簡素化します。

3. 外科的な変更（Surgical Changes）

必要なところだけ触る。後片付けは自分の出したゴミだけ。

隣接するコードやコメント、フォーマットを「改善」しない
壊れていないものをリファクタリングしない
自分ならこう書く、でも既存スタイルに合わせる
無関係なデッドコードを見つけたら、言及するだけで削除しない
import・変数・関数の削除は、自分の変更によって未使用になった場合だけ

検証基準：変更したすべての行が、ユーザーのリクエストに直接辿れること。

4. ゴール駆動実行（Goal-Driven Execution）

成功基準を定め、検証をループして通すまで回す。 命令形式のタスクは検証可能なゴールに変換します。「バリデーションを追加」は「不正な入力に対するテストを書き、通るようにする」に、「バグを修正」は「再現するテストを書き、通るようにする」に、「X をリファクタリング」は「前後でテストが通ることを保証する」になります。複数ステップの作業では、次のような形の計画を最初に示します。

1. [ステップ] → 検証: [チェック項目]
2. [ステップ] → 検証: [チェック項目]
3. [ステップ] → 検証: [チェック項目]

README が Karpathy に帰着させるキーインサイトはこうです。「LLM は明確なゴールに到達するまでループすることが極めて得意です……何をすべきか指示するのではなく、成功基準を渡して、走らせて見てください。」強い成功基準があればモデルは自律的にループでき、弱い基準（「動くようにして」）は絶えない確認作業を強います。

ガイドラインが機能しているかの判断材料も README が挙げています。diff に不要な変更が減る、過度な複雑化による書き直しが減る、実装の後にではなく実装の前に確認質問が来る、そして勝手にリファクタリングしない、クリーンで最小限の PR になる。

インストール方法

方法 A：Claude Code プラグイン（推奨）。 Claude Code 内で、まずマーケットプレイスを追加します。

/plugin marketplace add forrestchang/andrej-karpathy-skills

次にプラグインをインストールします。

/plugin install andrej-karpathy-skills@karpathy-skills

これでガイドラインが Claude Code プラグインとしてインストールされ、すべてのプロジェクトでスキルが使えるようになります。インストール元に注意：README のコマンドは forrestchang/andrej-karpathy-skills リポジトリを指しています。

方法 B：CLAUDE.md（プロジェクト単位）。 新規プロジェクトではそのままダウンロードします。

curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

既存プロジェクトでは、既存のファイルに追記します。

echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md

このガイドラインはプロジェクト固有の指示とマージして使う設計なので、既存の CLAUDE.md への追記は公式にサポートされた方法です。その下に「TypeScript の strict モードを使う」「すべての API エンドポイントにテストを書く」といった自分のプロジェクトルールを足していけます。Cursor ユーザー向けには、リポジトリに Cursor プロジェクトルール（.cursor/rules/karpathy-guidelines.mdc）がコミットされており、セットアップはリポジトリの CURSOR.md で解説されています。

Claude Code が必要？

このプロジェクトは Claude Code 向けに作られています。方法 A は Claude Code プラグインとして、方法 B は Claude Code のプロジェクト指示ファイル CLAUDE.md を対象とします。普段から Claude Code を使っているなら、インストールして終わりです。

別のハーネスを使っている場合への率直な答えはこうです。Claude Code がなくても恩恵は受けられますが、パッケージ化された体験は得られません。中身はプレーンな Markdown のルールセットなので、プロジェクトの指示ファイルを読むエージェントなら、同じテキストをそのまま適用できます。4 つの原則を自分のエージェントの指示ファイルに貼り付ければ、価値の大部分は再現できます。Cursor ルールがリポジトリに同梱されているのも、同じ理由からです。

どのハーネスを使う場合でも、README のトレードオフの記述は頭に入れておいてください。このガイドラインは速度より慎重さに寄っています。些末なタスク —— タイポ修正、明白な 1 行変更 —— では完全な手順ではなく判断力を使ってください。狙いは、自明でない作業での高くつくミスを減らすことであり、単純なタスクを遅くすることではありません。

よくある質問（FAQ）

Andrej Karpathy skills は Karpathy 公式のプロダクトですか？ いいえ。リポジトリは Karpathy が公開した観察をルールセットに整理したもので、コミュニティプロジェクトであり、MIT ライセンスです。README は彼の投稿を引用していますが、本人が開発したわけでも、このパッケージを支持しているわけでもありません。

プラグインと CLAUDE.md、どちらで入れるべき？ README が推奨するのはプラグインです。すべてのプロジェクトに効きます。CLAUDE.md 方式はプロジェクト単位で、既存のプロジェクトルールと混ぜられます。ガイドラインを 1 つのコードベースに限定したい場合はこちらを選びましょう。

これは DeepSeek Harness プラグインですか？ ネイティブには違います。Claude Code プラグイン / CLAUDE.md ファイルとして提供されており、dsh プラグインではありません。ただし原則そのものはハーネスに依存しないので、dsh ユーザーも同じ 4 つのルールを自分のエージェント指示に採用できます。

単純なタスクが遅くなりませんか？ その懸念は README 自身が扱っています。ガイドラインは速度より慎重さに寄っているので、些末な変更では判断力を使い、完全なプロセスを適用しなくてよい、としています。

Cursor でも使えますか？ 使えます。リポジトリには Cursor プロジェクトルール .cursor/rules/karpathy-guidelines.mdc がコミットされており、セットアップは CURSOR.md で解説されています。