CLAUDE.md Karpathy, Dijelaskan: Satu File di Balik Skills Search

Di Google Trends, di seluruh dunia, selama tujuh hari terakhir dan dibaca pada 23 Oktober 2026, "karpathy skills" muncul sebagai kueri yang meningkat di bawah kata kunci awal "claude skills". Siapa pun yang menelusuri pencarian itu akan berakhir di tempat yang sama: github.com/multica-ai/andrej-karpathy-skills, sebuah repositori yang menunjukkan 222.612 bintang di GitHub, dibaca pada 23 Oktober 2026. Deskripsinya sama sekali tidak memuat kata skill. Bunyinya: "Satu file CLAUDE.md untuk meningkatkan perilaku Claude Code, yang diturunkan dari pengamatan Andrej Karpathy tentang jebakan pemrograman LLM."

Kesenjangan antara kueri dan objek bukanlah hal teknis kecil. Sebuah skill dan berkas CLAUDE.md adalah mekanisme berbeda yang melakukan pekerjaan berbeda, dan hampir setiap klaim orang tentang repositori ini bergantung pada mengetahui yang mana di antara keduanya atau secara diam-diam mengasumsikan yang salah. Panduan di dalamnya adalah satu berkas. Repositori di sekitar berkas itu juga membawa manifes plugin dan sebuah folder di bawah skills, yang mungkin menjadi asal kata di bilah pencarian. Memisahkan pengemasan dari muatan adalah langkah pertama yang berguna di sini.

Angka-angka ini, semuanya dari GitHub dan dibaca pada 23 Oktober 2026: {{1}}222.612 bintang, 22.321 fork, dibuat 27 Januari 2026, terakhir di-push 20 April 2026, lisensi MIT{{/1}}. Pasangan terakhir itulah yang menarik. Repositori ini belum menerima push selama sekitar enam bulan, dan jumlah bintangnya tetap terus naik.

File-nya yang melakukan pekerjaan; kemasannya menjelaskan istilah pencarian.

Buka repositori tersebut, dan daftar berkasnya membuat ketidaksesuaian itu mudah terlihat. Ada CLAUDE.md di direktori akar, dan di sampingnya ada CURSOR.md, EXAMPLES.md, folder .cursor/rules yang berisi pedoman yang sama sebagai aturan proyek Cursor, folder .claude-plugin, dan direktori skills/karpathy-guidelines. Rute instalasi yang direkomendasikan README adalah marketplace plugin, dan README tersebut menjelaskan hasilnya sebagai membuat "the skill available across all your projects".

Jadi istilah pencariannya tidak salah, hanya kurang tepat. Ada folder skills. Ada plugin. Yang tidak ada adalah sekumpulan skill terpisah yang masing-masing mengerjakan tugas berbeda, yang biasanya dimaksud orang dengan skill pack: sebuah folder berisi SKILL.md dan file pendukung apa pun yang dibutuhkan kemampuan tersebut, yang dipanggil untuk satu tugas. Di sini seluruh panduannya adalah satu dokumen berisi instruksi tetap, dan plugin hadir untuk mengantarkan dokumen itu ke dalam sebuah proyek.

Apakah perbedaan itu penting bagi Anda bergantung pada apa yang Anda inginkan dari pencarian tersebut. Jika Anda mencari kotak peralatan, ini bukan itu. Jika Anda menginginkan buku aturan singkat yang mengubah perilaku agen pengodean di seluruh proyek, itulah tepatnya, dan penting untuk memahami mengapa seseorang menulisnya sebagai file alih-alih sebagai keterampilan.

Keluhan-keluhan yang menjadi sasaran penulisan itu

Sumber yang dinyatakan dalam README adalah sebuah unggahan Andrej Karpathy di X, yang dikutip README untuk tiga keluhan tentang cara model menulis kode. Ketiganya layak dibaca secara lengkap, karena keempat prinsip tersebut hampir bersesuaian satu per satu dengannya.

Yang pertama: model "membuat asumsi yang salah atas nama Anda dan langsung mengikutinya tanpa memeriksa," dan "tidak mengelola kebingungan mereka, tidak mencari klarifikasi, tidak memunculkan inkonsistensi, tidak menyajikan trade-off, tidak membantah ketika seharusnya." Perhatikan apa yang sedang dijelaskan. Ini bukan keluhan tentang jawaban yang salah. Ini keluhan tentang jawaban salah yang lancar disampaikan tanpa keraguan, di mana ketidakpastian yang seharusnya memunculkan pertanyaan justru menghasilkan kode yang percaya diri.

Yang kedua: mereka "sangat suka membuat kode dan API menjadi terlalu rumit, menggembungkan abstraksi, tidak membersihkan kode mati… mengimplementasikan konstruksi yang membengkak lebih dari 1000 baris padahal 100 baris saja sudah cukup." Yang itu akrab bagi siapa pun yang pernah meminta sebuah fitur dan malah menerima sebuah framework.

Yang ketiga lebih halus dan, bagi siapa pun yang meninjau diff, paling mahal: mereka "masih terkadang mengubah/menghapus komentar dan kode yang tidak cukup mereka pahami sebagai efek samping, bahkan jika ortogonal terhadap tugas." Suntingan ortogonal pada satu komentar kecil dampaknya jika berdiri sendiri. Jika dikalikan di seluruh basis kode, itulah cara antrean tinjauan dipenuhi perubahan yang tidak diminta siapa pun, dan cara komentar yang menjelaskan solusi sementara hilang sebelum siapa pun mengetahui mengapa solusi sementara itu ada.

Empat prinsip, dan ujian yang ditinggalkan masing-masing

Berkas ini memuat empat prinsip. Masing-masing disertai sekumpulan aturan singkat, dan dua di antaranya merinci uji satu baris yang bisa Anda terapkan pada sebuah diff tanpa perlu memasang apa pun. Aturan-aturan itulah yang memperlihatkan karakter berkas ini.

Berpikir Sebelum Coding

Instruksi pada judulnya adalah "Jangan berasumsi. Jangan sembunyikan kebingungan. Tampilkan trade-off." Di bawahnya: nyatakan asumsi secara eksplisit dan bertanyalah daripada menebak; ajukan beberapa interpretasi ketika permintaan ambigu; bantah ketika ada pendekatan yang lebih sederhana; berhenti ketika bingung, sebutkan apa yang tidak jelas, dan minta klarifikasi. Ini secara langsung ditujukan pada keluhan pertama. Mekanismenya bukan "lebih berhati-hati" — melainkan mengubah pilihan-pilihan diam-diam menjadi pilihan yang terlihat, sehingga peninjau dapat tidak setuju sebelum kode ada, bukan setelahnya.

Utamakan Kesederhanaan

Aturannya adalah kode seminimal mungkin yang menyelesaikan masalah, tanpa hal yang spekulatif: tidak ada fitur melebihi yang diminta, tidak ada abstraksi untuk kode yang hanya dipakai sekali, tidak ada fleksibilitas atau kemampuan konfigurasi yang tidak diminta siapa pun, tidak ada penanganan kesalahan untuk skenario yang mustahil, dan "jika 200 baris bisa menjadi 50, tulis ulang". Ujinya adalah satu pertanyaan — apakah seorang senior engineer akan mengatakan ini terlalu rumit? — yang merupakan soal pertimbangan, dan secara terbuka memang begitu.

Perubahan Pembedahan

Di sini file membagi instruksi menjadi dua, yang merupakan hal paling berguna di dalamnya. Saat mengedit kode yang sudah ada: jangan perbaiki kode, komentar, atau format di sekitarnya; jangan lakukan refactor pada hal yang tidak rusak; ikuti gaya yang ada meskipun Anda akan melakukannya dengan cara berbeda; sebutkan kode mati yang tidak terkait alih-alih menghapusnya. Saat perubahan Anda sendiri menciptakan orphan: hapus impor, variabel, dan fungsi yang menjadi tidak terpakai akibat perubahan Anda, tetapi biarkan kode mati yang sudah ada sebelumnya kecuali diminta. Ujinya adalah bahwa setiap baris yang diubah dapat ditelusuri langsung ke permintaan.

Eksekusi Berbasis Tujuan

Tetapkan kriteria keberhasilan dan ulangi hingga terverifikasi. README menunjukkan transformasi sebagai pasangan. Alih-alih "menambahkan validasi", tulis pengujian untuk input tidak valid lalu buat pengujian itu lulus. Alih-alih "memperbaiki bug", tulis pengujian yang mereproduksinya lalu buat pengujian itu lulus. Alih-alih "merefaktor X", pastikan pengujian lulus sebelum dan sesudah. Untuk pekerjaan bertahap, ini meminta rencana singkat yang setiap langkahnya menyebutkan verifikasinya sendiri. README mengutip Karpathy lagi di sini: "LLM sangat baik dalam melakukan perulangan hingga mencapai tujuan tertentu… Jangan beri tahu apa yang harus dilakukan, berikan kriteria keberhasilan dan lihatlah ia berjalan."

Sebuah file, sebuah skill, dan sebuah plugin adalah tiga hal yang berbeda

Ada baiknya bersikap tepat tentang mekanismenya, karena perilaku praktisnya berbeda. CLAUDE.md adalah berkas instruksi proyek: teks yang dibaca Claude Code sebagai konteks tetap untuk sebuah repositori, hadir baik ada yang memintanya pada giliran ini maupun tidak. Skill adalah folder dengan SKILL.md yang menjelaskan kapan kemampuan tersebut harus digunakan, dimuat ketika suatu tugas memerlukannya dan bukan sebelumnya. Plugin adalah paket distribusi, dipasang melalui marketplace, yang dapat membawa skill, perintah, dan komponen lain. Perbedaannya adalah tentang kapan instruksi masuk ke konteks dan siapa yang memutuskan, bukan tentang kualitas.

Dalam pengertian itu, CLAUDE.md adalah yang paling blak-blakan dari ketiganya. File ini selalu aktif di proyek tersebut, berlaku untuk setiap tugas di dalamnya, dan mengonsumsi konteks pada setiap giliran, baik pekerjaannya berupa perbaikan typo satu baris maupun migrasi. README milik file itu sendiri mengakui biaya tersebut dalam bagian bernama Tradeoff Note: pedomannya lebih condong ke kehati-hatian daripada kecepatan, dan untuk tugas sepele — perbaikan typo sederhana, one-liner yang jelas — Anda harus menggunakan pertimbangan. Dikatakan bahwa tujuannya adalah mengurangi kesalahan yang mahal pada pekerjaan non-sepele, bukan memperlambat pekerjaan yang sederhana.

Itu adalah gambaran yang adil tentang apa yang dapat dilakukan oleh berkas instruksi tetap. Berkas itu tidak dapat menambahkan kemampuan yang tidak dimiliki model. Berkas itu hanya dapat membuat perilaku model yang sudah ada menjadi lebih mungkin atau kurang mungkin terjadi. Itulah sebabnya berkas tersebut ditulis sebagai batasan — jangan lakukan ini, tanyakan sebelum melakukan itu — bukan sebagai dorongan untuk menjadi lebih baik.

Apa yang diukur oleh 222,612 bintang

Angka-angka itu mengukur perhatian. Itu bukan berarti mengabaikannya, dan bukan pula hal yang tidak berarti: sebuah repositori yang dibuat pada Januari 2026 dan terakhir di-push pada April mencapai 222.612 bintang dan 22.321 fork pada 23 Oktober 2026, di GitHub, dibaca pada hari itu, yang berarti repositori itu dibagikan secara luas dan di-fork oleh orang-orang yang ingin memiliki salinannya sendiri. Jumlah bintang adalah proksi yang wajar untuk seberapa banyak orang yang menganggap sesuatu layak untuk di-bookmark.

Ini bukan proksi untuk efek, dan repositori tidak berpura-pura sebaliknya. Yang tidak diterbitkan di mana pun di dalamnya: benchmark apa pun yang membandingkan hasil dengan dan tanpa file tersebut, metodologi apa pun untuk mengukur apakah file itu berfungsi, dan perbandingan apa pun terhadap kontrol. Tidak ada perbandingan sebelum-dan-sesudah pada basis kode nyata, tidak ada studi peninjau, tidak ada tingkat insiden. File seperti ini adalah hipotesis tentang perilaku model, yang dinyatakan dengan elegan, dan tidak ada yang menjalankan uji coba tersebut.

Sebagai gantinya, README menawarkan bagian bernama How to Know It's Working, yang mencantumkan empat hal yang mungkin Anda amati: lebih sedikit perubahan yang tidak perlu dalam diff, lebih sedikit penulisan ulang akibat kerumitan berlebihan, pertanyaan klarifikasi yang datang sebelum implementasi alih-alih setelah terjadi kesalahan, dan pull request minimal yang bersih. Itu adalah sinyal yang masuk akal. Itu juga persis seperti yang akan Anda tulis jika Anda belum mengukur apa pun, dan itu dilaporkan sendiri oleh siapa pun yang menerapkan file tersebut. Bacalah sebagai daftar periksa untuk menguji file tersebut di repositori Anda sendiri, bukan sebagai bukti bahwa file itu sudah lulus.

Apa yang sebenarnya Anda ketik untuk menginstalnya

README memberikan dua jalur. Jalur yang direkomendasikan berjalan di dalam Claude Code: tambahkan marketplace, lalu pasang plugin, setelah itu pedomannya tersedia di seluruh proyek, bukan per repositori. Jalur kedua bersifat per proyek: ambil CLAUDE.md mentah ke repositori baru, atau tambahkan ke repositori yang sudah ada. Ada juga aturan proyek Cursor yang telah dikomit, sehingga pedoman yang sama berlaku saat folder dibuka di Cursor — sebuah detail yang menunjukkan bahwa file tersebut ditulis agar portabel di berbagai alat yang membaca file instruksi tingkat proyek, bukan terikat pada loader milik satu vendor.

Satu hal yang kurang mulus, layak diperhatikan karena Anda akan menemukannya jika mengikuti README secara persis. Perintah marketplace menyebutkan forrestchang/andrej-karpathy-skills, sedangkan URL repositori di bagian atas halaman adalah multica-ai/andrej-karpathy-skills. Kedua string muncul di README yang sama, dibaca pada 23 Oktober 2026. Saya dapat melihat ketidakcocokannya dan tidak dapat memberi tahu Anda mengapa itu ada, jadi saran jujurnya adalah coba jalur lainnya jika salah satu gagal, dan anggap salah satu dari dua string itu sudah usang.

Hal lain yang perlu diperhatikan di halaman depan: repositori ini dikelola oleh multica-ai, dan blockquote pembuka README mempromosikan Multica, "platform open-source untuk menjalankan dan mengelola agen coding dengan skill yang dapat digunakan kembali." Itu adalah pengungkapan yang sah, dan juga menjadi petunjuk mengapa pengemasannya terlihat seperti itu. Proyek yang tertarik pada skill yang dapat digunakan kembali kemungkinan akan menyertakan panduannya sendiri sebagai sesuatu yang dapat dipasang, dan itulah plugin ini.

Menggunakannya tanpa mewarisi asumsinya

Bagian Kustomisasi adalah bagian yang paling sering dilewati pembaca. File ini dirancang untuk digabungkan dengan instruksi khusus proyek, bukan untuk menggantikannya, dan contoh-contoh yang diberikannya konkret: gunakan mode strict TypeScript, semua endpoint API harus memiliki pengujian, ikuti pola penanganan error yang sudah ada di file tertentu. Itu bukan sekadar dekorasi. Itulah bedanya antara buku aturan generik dan kumpulan instruksi yang tahu di mana kode Anda berada.

Ada alasan praktis untuk menggabungkan alih-alih menumpuk. Jika Anda menempelkan file itu apa adanya dan proyek Anda memiliki konvensinya sendiri, kedua rangkaian instruksi dapat saling bertentangan, dan model yang merekonsiliasi pertentangan tersebut justru merupakan kekacauan yang ingin dihilangkan oleh prinsip pertama. Menuliskan konvensi Anda ke dalam file yang sama, dengan gaya yang sama, menjaga permukaan instruksi tetap cukup kecil untuk diaudit.

Dan Anda memang harus mengauditnya. Ini adalah dokumen singkat berisi instruksi perilaku yang akan berlaku untuk setiap permintaan di repositori. Pertanyaan yang tepat bukanlah apakah 222.612 orang bisa saja salah — kerangka berpikir itu tidak membuktikan apa pun — melainkan apakah setiap aturan cocok dengan kegagalan yang benar-benar pernah Anda lihat. Jika diff Anda belum pernah memuat penulisan ulang komentar secara sambil lalu, bagian Surgical Changes hanya membuang konteks Anda tanpa manfaat. Hapus bagian itu. File ini berlisensi MIT dan memang dimaksudkan untuk diedit.

Satu lapisan lebih dalam, tidak ada dari ini yang mengubah model mana yang menjawab. File CLAUDE.md membentuk bagaimana suatu permintaan ditangani setelah mencapai model; file ini tidak mengatakan apa pun tentang model yang menerimanya. Keputusan kedua itu menjadi milik apa pun yang berada di depan model. Salah satu cara mengaturnya adalah satu endpoint yang kompatibel dengan OpenAI yang membawa lebih dari 200 model di bawah satu kunci, dengan failover otomatis antarpenyedia dan harga daftar penyedia diteruskan pada markup 0%. Kami menghosting model; kami tidak membuat Claude Code, dan tidak ada apa pun di repositori Anda yang terlihat oleh kami.

Pencarian akan terus menyebut skills, karena itulah kata yang digunakan orang untuk sesuatu yang Anda pasang agar agen berperilaku berbeda, dan kemasan di sekitar repositori ini juga memakainya. Artefaknya adalah sebuah berkas: satu dokumen berisi instruksi tetap, yang ditulis untuk menjawab tiga keluhan spesifik, dengan empat prinsip dan serangkaian uji yang dapat Anda terapkan secara manual. Nilailah berdasarkan apakah keluhan-keluhan itu terdengar seperti repositori Anda. Itu pertanyaan yang lebih baik daripada jumlah bintang, yang selama ini hanya mengukur berapa banyak orang yang mengalami reaksi yang sama seperti yang baru saja Anda alami.