Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
{
"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
"name": "andrej-karpathy-skills",
"description": "Karpathy-inspired coding-agent guidelines, the skillify / check-resolvable meta-skills, and the /scalable decision test.",
"name": "greybeard",
"description": "Greybeard — Karpathy-inspired coding-agent guidelines, the skillify / check-resolvable meta-skills, and the /scalable decision test.",
"owner": {
"name": "Clawnify",
"url": "https://github.com/clawnify"
},
"plugins": [
{
"name": "andrej-karpathy-skills",
"name": "greybeard",
"description": "skillify + check-resolvable skills and the /scalable command. Pair with the npx installer for the always-on guidelines.",
"source": "./",
"category": "productivity"
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "andrej-karpathy-skills",
"name": "greybeard",
"description": "Karpathy-inspired coding-agent skills: skillify (capture repeated work), check-resolvable (keep skills DRY + MECE), and the /scalable decision test.",
"author": {
"name": "Clawnify",
Expand Down
30 changes: 19 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,21 @@
<img src="assets/greybeard.png" width="320" alt="The Greybeard — Principal Engineer">
</p>

<h1 align="center">Karpathy-Inspired Coding-Agent Guidelines</h1>
<h1 align="center">Greybeard</h1>

<p align="center">
<sub>Karpathy-inspired guardrails that make your AI coding agent behave like a principled senior engineer.</sub>
</p>

<p align="center">
<em>Make your agent code like the senior who's been paged at 3am for every shortcut you're about to take.</em><br>
<strong>"Did you check, or did you guess?"</strong>
</p>

<p align="center">
<code>npx @clawnify/greybeard</code>
</p>

> Built and maintained by [Clawnify](https://clawnify.com) — a managed platform that provisions AI agents with WhatsApp / Telegram / Email and browser capabilities for non-technical users.

A single `CLAUDE.md` file to improve AI coding-agent behavior, derived from [Andrej Karpathy's observations](https://x.com/karpathy/status/2015883857489522876) on LLM coding pitfalls, plus three sections we added for the AI-assisted-coding era. Ships with two runnable [meta-skills](#skills-skillify-dry--mece-resolvers), the [`/scalable`](#the-scalable-command) decision command, and a [one-command installer](#install) that fans it all out to every AI coding agent you use.
Expand Down Expand Up @@ -189,34 +197,34 @@ Then `/scalable` (tests the current direction) or `/scalable <a specific decisio
**One command — every agent on your machine:**

```bash
npx andrej-karpathy-skills
npx @clawnify/greybeard
```

It detects the AI coding agents you actually use and installs the right files for each: the seven guidelines into the rule file each one reads (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursor/rules/`, `.windsurf/rules/`, `.clinerules/`, `.github/copilot-instructions.md`), plus the `skillify` / `check-resolvable` skills and the `/scalable` command for Claude Code and OpenClaw. Shared files are edited between markers, so re-running is a safe no-op and your own content is preserved.

```bash
npx andrej-karpathy-skills --list # show detected agents
npx andrej-karpathy-skills --all # install for all agents, detected or not
npx andrej-karpathy-skills --only cursor # just one (repeatable)
npx andrej-karpathy-skills --dry-run # preview without writing
npx andrej-karpathy-skills --uninstall # remove what it added
npx @clawnify/greybeard --list # show detected agents
npx @clawnify/greybeard --all # install for all agents, detected or not
npx @clawnify/greybeard --only cursor # just one (repeatable)
npx @clawnify/greybeard --dry-run # preview without writing
npx @clawnify/greybeard --uninstall # remove what it added
```

Supported: **Claude Code, Cursor, Windsurf, Cline, GitHub Copilot, Codex, Gemini CLI, OpenClaw** — and any agent that reads `CLAUDE.md` / `AGENTS.md`.

**Claude Code plugin marketplace** (the skills + `/scalable`):

```
/plugin marketplace add clawnify/andrej-karpathy-skills
/plugin install andrej-karpathy-skills
/plugin marketplace add clawnify/greybeard
/plugin install greybeard
```

**Manual** (just the guidelines, one file — no Node):

```bash
curl -o CLAUDE.md https://raw.githubusercontent.com/clawnify/andrej-karpathy-skills/main/CLAUDE.md
curl -o CLAUDE.md https://raw.githubusercontent.com/clawnify/greybeard/main/CLAUDE.md
# …or append to an existing CLAUDE.md / AGENTS.md:
curl https://raw.githubusercontent.com/clawnify/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
curl https://raw.githubusercontent.com/clawnify/greybeard/main/CLAUDE.md >> CLAUDE.md
```

> The per-agent rule files are generated from `CLAUDE.md` (the single source) by `scripts/build-rules.js`. Contributors: edit `CLAUDE.md`, run `npm run build`, commit. CI (`npm run check-sync`) fails if a copy drifts.
Expand Down
16 changes: 8 additions & 8 deletions bin/install.js
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
#!/usr/bin/env node
'use strict';

// andrej-karpathy-skills — cross-platform installer.
// greybeard — cross-platform installer.
//
// Detects the AI coding agents on your machine / in this project and installs
// the Karpathy-inspired guidelines (+ Claude Code skills and the /scalable
// command) into each one's rule location. Pure Node stdlib, zero runtime deps.
//
// npx andrej-karpathy-skills # install for every detected agent
// npx andrej-karpathy-skills --all # install for all agents, detected or not
// npx andrej-karpathy-skills --only claude --only cursor
// npx andrej-karpathy-skills --dry-run # show what would change
// npx andrej-karpathy-skills --uninstall
// npx @clawnify/greybeard # install for every detected agent
// npx @clawnify/greybeard --all # install for all agents, detected or not
// npx @clawnify/greybeard --only claude --only cursor
// npx @clawnify/greybeard --dry-run # show what would change
// npx @clawnify/greybeard --uninstall

const fs = require('fs');
const os = require('os');
Expand Down Expand Up @@ -190,10 +190,10 @@ function main() {
}

function printHelp() {
console.log(`andrej-karpathy-skills installer
console.log(`greybeard installer

Usage:
npx andrej-karpathy-skills [flags]
npx @clawnify/greybeard [flags]

Flags:
--all install for every supported agent, detected or not
Expand Down
13 changes: 6 additions & 7 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,19 +1,18 @@
{
"name": "andrej-karpathy-skills",
"name": "@clawnify/greybeard",
"version": "0.1.0",
"description": "Karpathy-inspired coding-agent guidelines + skillify / check-resolvable skills + the /scalable decision test, installable across every AI coding agent.",
"description": "Greybeard — Karpathy-inspired guardrails that make your AI coding agent behave like a principled senior engineer. Guidelines + skillify / check-resolvable skills + the /scalable decision test, installable across every AI coding agent.",
"license": "MIT",
"homepage": "https://github.com/clawnify/andrej-karpathy-skills",
"homepage": "https://github.com/clawnify/greybeard",
"repository": {
"type": "git",
"url": "git+https://github.com/clawnify/andrej-karpathy-skills.git"
"url": "git+https://github.com/clawnify/greybeard.git"
},
"bugs": {
"url": "https://github.com/clawnify/andrej-karpathy-skills/issues"
"url": "https://github.com/clawnify/greybeard/issues"
},
"bin": {
"andrej-karpathy-skills": "./bin/install.js",
"karpathy-skills": "./bin/install.js"
"greybeard": "./bin/install.js"
},
"engines": {
"node": ">=18"
Expand Down
Loading