{"id":"f8fb0910-79db-445f-a439-487788cdcc02","entityType":"agent","slug":"clawhub-sg345662365-oss-andrej-karpathy-skills","name":"Andrej Karpathy Skills","canonicalUrl":"https://www.xpersona.co/agent/clawhub-sg345662365-oss-andrej-karpathy-skills","canonicalPath":"/agent/clawhub-sg345662365-oss-andrej-karpathy-skills","generatedAt":"2026-10-11T05:39:16.122Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T03:05:57.847Z","emptyReason":null},"description":"Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes... Skill: Andrej Karpathy Skills Owner: sg345662365-oss Summary: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-06-08T05:53:11.421Z | auto - Initial release of Karpathy Guidelines for coding with LLMs. - Outlines behavioral principles to avoid common mistakes","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s1767amm59pfp2m38fw70nts75886f6v:andrej-karpathy-skills","sourceUrl":"https://clawhub.ai/sg345662365-oss/andrej-karpathy-skills","homepage":"https://clawhub.ai/sg345662365-oss/skills/andrej-karpathy-skills","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/sg345662365-oss/andrej-karpathy-skills","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/sg345662365-oss/skills/andrej-karpathy-skills","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:05:57.847Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:05:57.847Z","emptyReason":null},"stars":null,"forks":null,"downloads":1178,"packageName":null,"latestVersion":"1.0.0","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:05:57.784Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T03:05:57.847Z","lastCrawledAt":"2026-10-11T03:05:57.784Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T03:05:57.784Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.0","createdAt":"2026-06-08T05:53:11.421Z","changelog":"- Initial release of Karpathy Guidelines for coding with LLMs. - Outlines behavioral principles to avoid common mistakes: think before coding, prioritize simplicity, make surgical code changes, and define clear success criteria. - Emphasizes surfacing assumptions, reducing overcomplication, and verifying changes against explicit goals. - Includes practical rules for editing existing code without unnecessary refactoring or feature creep.","fileCount":10,"zipByteSize":17328}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1767amm59pfp2m38fw70nts75886f6v:andrej-karpathy-skills","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T05:39:16.120Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sg345662365-oss-andrej-karpathy-skills/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T03:05:57.847Z","emptyReason":null},"readme":"Skill: Andrej Karpathy Skills\n\nOwner: sg345662365-oss\n\nSummary: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes...\n\nTags: latest:1.0.0\n\nVersion history:\n\nv1.0.0 | 2026-06-08T05:53:11.421Z | auto\n\n- Initial release of Karpathy Guidelines for coding with LLMs.\n- Outlines behavioral principles to avoid common mistakes: think before coding, prioritize simplicity, make surgical code changes, and define clear success criteria.\n- Emphasizes surfacing assumptions, reducing overcomplication, and verifying changes against explicit goals.\n- Includes practical rules for editing existing code without unnecessary refactoring or feature creep.\n\nArchive index:\n\nArchive v1.0.0: 10 files, 17328 bytes\n\nFiles: CURSOR.md (724b), EXAMPLES.md (15360b), install/targets.json (27098b), LICENSE (1120b), package.json (1303b), README.md (5590b), README.zh.md (3614b), skill-card.md (2033b), SKILL.md (2571b), _meta.json (141b)\n\nFile v1.0.0:SKILL.md\n\n---\r\nname: karpathy-guidelines\r\ndescription: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.\r\n---\r\n\r\n# Karpathy Guidelines\r\n\r\nBehavioral guidelines to reduce common LLM coding mistakes, derived from [Andrej Karpathy's observations](https://x.com/karpathy/status/2015883857489522876) on LLM coding pitfalls.\r\n\r\n**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.\r\n\r\n## 1. Think Before Coding\r\n\r\n**Don't assume. Don't hide confusion. Surface tradeoffs.**\r\n\r\nBefore implementing:\r\n- State your assumptions explicitly. If uncertain, ask.\r\n- If multiple interpretations exist, present them - don't pick silently.\r\n- If a simpler approach exists, say so. Push back when warranted.\r\n- If something is unclear, stop. Name what's confusing. Ask.\r\n\r\n## 2. Simplicity First\r\n\r\n**Minimum code that solves the problem. Nothing speculative.**\r\n\r\n- No features beyond what was asked.\r\n- No abstractions for single-use code.\r\n- No \"flexibility\" or \"configurability\" that wasn't requested.\r\n- No error handling for impossible scenarios.\r\n- If you write 200 lines and it could be 50, rewrite it.\r\n\r\nAsk yourself: \"Would a senior engineer say this is overcomplicated?\" If yes, simplify.\r\n\r\n## 3. Surgical Changes\r\n\r\n**Touch only what you must. Clean up only your own mess.**\r\n\r\nWhen editing existing code:\r\n- Don't \"improve\" adjacent code, comments, or formatting.\r\n- Don't refactor things that aren't broken.\r\n- Match existing style, even if you'd do it differently.\r\n- If you notice unrelated dead code, mention it - don't delete it.\r\n\r\nWhen your changes create orphans:\r\n- Remove imports/variables/functions that YOUR changes made unused.\r\n- Don't remove pre-existing dead code unless asked.\r\n\r\nThe test: Every changed line should trace directly to the user's request.\r\n\r\n## 4. Goal-Driven Execution\r\n\r\n**Define success criteria. Loop until verified.**\r\n\r\nTransform tasks into verifiable goals:\r\n- \"Add validation\" → \"Write tests for invalid inputs, then make them pass\"\r\n- \"Fix the bug\" → \"Write a test that reproduces it, then make it pass\"\r\n- \"Refactor X\" → \"Ensure tests pass before and after\"\r\n\r\nFor multi-step tasks, state a brief plan:\r\n```\r\n1. [Step] → verify: [check]\r\n2. [Step] → verify: [check]\r\n3. [Step] → verify: [check]\r\n```\r\n\r\nStrong success criteria let you loop independently. Weak criteria (\"make it work\") require constant clarification.\n\nFile v1.0.0:README.md\n\n# Karpathy-Inspired Agent Skills\r\n\r\nKarpathy-inspired coding-agent guidelines packaged for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Aider, GitHub Copilot, OpenClaw, Warp, Windsurf, Cline, and the wider SwarmVault/SwarmClaw agent matrix.\r\n\r\nThe canonical source is [`skills/karpathy-guidelines/SKILL.md`](skills/karpathy-guidelines/SKILL.md). Agent-specific files are generated under [`adapters/`](adapters/) so the repository root stays readable while every supported tool receives the same behavioral guidance.\r\n\r\nEnglish | [Simplified Chinese](./README.zh.md)\r\n\r\n## What This Adds\r\n\r\nThese guidelines address four common LLM coding failure modes described by Andrej Karpathy:\r\n\r\n| Principle | Prevents |\r\n| --- | --- |\r\n| Think Before Coding | Silent assumptions, hidden confusion, missing tradeoffs |\r\n| Simplicity First | Over-engineering, bloated abstractions, speculative features |\r\n| Surgical Changes | Drive-by rewrites, unrelated cleanup, accidental behavior changes |\r\n| Goal-Driven Execution | Vague completion criteria and unverified changes |\r\n\r\nThe content is intentionally short. It is meant to merge with project-specific instructions, not replace them.\r\n\r\n## Quick Install\r\n\r\nInstall through npm and run the installer with `npx`:\r\n\r\n```bash\r\nnpx @swarmclawai/andrej-karpathy-skills --list\r\nnpx @swarmclawai/andrej-karpathy-skills --agent codex --dest /path/to/project\r\n```\r\n\r\nOr install the CLI globally:\r\n\r\n```bash\r\nnpm install -g @swarmclawai/andrej-karpathy-skills\r\nandrej-karpathy-skills --agent cursor --dest /path/to/project\r\n```\r\n\r\nThe CLI copies the right adapter from the npm package into the destination project.\r\n\r\n## Clone Install\r\n\r\nClone once, then copy the right adapter into any project. The installer reads [`install/targets.json`](install/targets.json), copies from `adapters/<agent-id>/...`, and writes to the real path your agent expects.\r\n\r\n```bash\r\ngit clone https://github.com/swarmclawai/andrej-karpathy-skills.git\r\ncd andrej-karpathy-skills\r\nnode scripts/install.mjs --list\r\nnode scripts/install.mjs --agent codex --dest /path/to/project\r\n```\r\n\r\nUse `--force` if you intentionally want to overwrite an existing instruction file:\r\n\r\n```bash\r\nnode scripts/install.mjs --agent claude --dest /path/to/project --force\r\nnode scripts/install.mjs --agent openclaw --dest /path/to/project --force\r\n```\r\n\r\nUse `--global` for agents with supported user-level skill locations:\r\n\r\n```bash\r\nnode scripts/install.mjs --agent claude --global --force\r\nnode scripts/install.mjs --agent hermes --global --force\r\n```\r\n\r\n## Adapter Layout\r\n\r\nIf you only need one file, copy the adapter source to the install target shown below:\r\n\r\n| Agent | Adapter source | Installs to |\r\n| --- | --- |\r\n| Codex | `adapters/codex/AGENTS.md` | `AGENTS.md` |\r\n| Claude Code | `adapters/claude/CLAUDE.md` | `CLAUDE.md` |\r\n| Cursor | `adapters/cursor/.cursor/rules/karpathy-guidelines.mdc` | `.cursor/rules/karpathy-guidelines.mdc` |\r\n| Gemini CLI | `adapters/gemini/GEMINI.md` | `GEMINI.md` |\r\n| Aider | `adapters/aider/CONVENTIONS.md` | `CONVENTIONS.md` |\r\n| GitHub Copilot | `adapters/copilot/.github/copilot-instructions.md` | `.github/copilot-instructions.md` |\r\n| VS Code Copilot Chat | `adapters/vscode/.github/chatmodes/karpathy-guidelines.chatmode.md` | `.github/chatmodes/karpathy-guidelines.chatmode.md` |\r\n| OpenClaw | `adapters/openclaw/.openclaw/skills/karpathy-guidelines/SKILL.md` | `.openclaw/skills/karpathy-guidelines/SKILL.md` |\r\n| Warp or shared Agent Skills | `adapters/warp/.agents/skills/karpathy-guidelines/SKILL.md` | `.agents/skills/karpathy-guidelines/SKILL.md` |\r\n| Windsurf | `adapters/windsurf/.windsurfrules` | `.windsurfrules` |\r\n\r\nThe full target matrix lives in [`install/targets.json`](install/targets.json).\r\n\r\n## Supported Agent Matrix\r\n\r\nThe matrix is based on SwarmVault's installer targets and SwarmClaw's agent provider registry, then cross-checked with public agent documentation where available.\r\n\r\nCore targets:\r\n\r\n`codex`, `claude`, `cursor`, `goose`, `pi`, `gemini`, `opencode`, `aider`, `copilot`, `trae`, `claw`, `droid`, `kiro`, `hermes`, `antigravity`, `vscode`.\r\n\r\nExtended Agent Skills targets:\r\n\r\n`amp`, `augment`, `adal`, `bob`, `cline`, `codebuddy`, `command-code`, `continue`, `cortex`, `crush`, `deepagents`, `firebender`, `iflow`, `junie`, `kilo-code`, `kimi`, `kode`, `mcpjam`, `mistral-vibe`, `mux`, `neovate`, `openclaw`, `openhands`, `pochi`, `qoder`, `qwen-code`, `replit`, `roo-code`, `trae-cn`, `warp`, `windsurf`, `zencoder`.\r\n\r\nSee [`docs/agent-compatibility.md`](docs/agent-compatibility.md) for the research notes and source links.\r\n\r\n## Claude Code Plugin\r\n\r\nThis repo still includes Claude plugin metadata at the root because plugin tooling expects it there:\r\n\r\n```text\r\n.claude-plugin/plugin.json\r\n.claude-plugin/marketplace.json\r\nskills/karpathy-guidelines/SKILL.md\r\n```\r\n\r\nWhen published as a Claude plugin marketplace entry, the plugin exposes the same canonical skill used by every other adapter.\r\n\r\n## Maintain The Package\r\n\r\nEdit the canonical skill, then regenerate and verify:\r\n\r\n```bash\r\nnpm run generate\r\nnpm run verify\r\nnpm run pack:dry-run\r\n```\r\n\r\nGenerated adapters live under `adapters/<agent-id>/` and start with a comment that names their source. Do not edit generated adapters by hand; update `skills/karpathy-guidelines/SKILL.md` or `scripts/generate.mjs`.\r\n\r\n## Attribution\r\n\r\nThis package is based on the original [`forrestchang/andrej-karpathy-skills`](https://github.com/forrestchang/andrej-karpathy-skills) repository and preserves the MIT license attribution.\r\n\r\n## License\r\n\r\nMIT\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn795jyrb7x5a08fmcczzxpwy1886a3m\",\n  \"slug\": \"andrej-karpathy-skills\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1780897991421\n}\n\nFile v1.0.0:CURSOR.md\n\n# Using These Guidelines With Cursor\r\n\r\nCursor reads project rules from `.cursor/rules/`. This repository keeps the generated Cursor adapter under [`adapters/cursor/.cursor/rules/karpathy-guidelines.mdc`](adapters/cursor/.cursor/rules/karpathy-guidelines.mdc) so the repo root stays clean.\r\n\r\nInstall it into another project with:\r\n\r\n```bash\r\nnode scripts/install.mjs --agent cursor --dest /path/to/project\r\n```\r\n\r\nThat command copies the adapter to `.cursor/rules/karpathy-guidelines.mdc` in the destination project. The Cursor rule is generated from [`skills/karpathy-guidelines/SKILL.md`](skills/karpathy-guidelines/SKILL.md); edit the canonical skill and run `npm run generate` instead of editing the adapter directly.\n\nFile v1.0.0:EXAMPLES.md\n\n# Examples\r\n\r\nReal-world code examples demonstrating the four principles. Each example shows what LLMs commonly do wrong and how to fix it.\r\n\r\n---\r\n\r\n## 1. Think Before Coding\r\n\r\n### Example 1: Hidden Assumptions\r\n\r\n**User Request:** \"Add a feature to export user data\"\r\n\r\n**❌ What LLMs Do (Wrong Assumptions)**\r\n\r\n```python\r\ndef export_users(format='json'):\r\n    \"\"\"Export all users to a file.\"\"\"\r\n    users = User.query.all()\r\n    \r\n    if format == 'json':\r\n        with open('users.json', 'w') as f:\r\n            json.dump([u.to_dict() for u in users], f)\r\n    elif format == 'csv':\r\n        with open('users.csv', 'w') as f:\r\n            writer = csv.DictWriter(f, fieldnames=['id', 'email', 'name'])\r\n            writer.writeheader()\r\n            writer.writerows([u.to_dict() for u in users])\r\n    \r\n    return f\"Exported {len(users)} users\"\r\n```\r\n\r\n**Problems:**\r\n- Assumed it should export ALL users (what about pagination? privacy?)\r\n- Assumed file location without asking\r\n- Assumed which fields to include\r\n- Assumed CSV fieldnames without checking actual data structure\r\n\r\n**✅ What Should Happen (Surface Assumptions)**\r\n\r\n```\r\nBefore implementing, I need to clarify:\r\n\r\n1. **Scope**: Export all users or filtered subset? (privacy implications)\r\n2. **Format**: You mentioned \"export\" - did you mean:\r\n   - Download file in browser?\r\n   - Background job with email notification?\r\n   - API endpoint returning data?\r\n3. **Fields**: Which user fields? (some might be sensitive)\r\n4. **Volume**: How many users typically? (affects approach)\r\n\r\nSimplest approach: Add an API endpoint that returns paginated JSON.\r\nWould need more info for file-based exports.\r\n\r\nWhat's your preference?\r\n```\r\n\r\n### Example 2: Multiple Interpretations\r\n\r\n**User Request:** \"Make the search faster\"\r\n\r\n**❌ What LLMs Do (Pick Silently)**\r\n\r\n```python\r\n# Adds caching, database indexes, and async processing\r\n# without asking which \"faster\" matters\r\n@lru_cache(maxsize=1000)\r\nasync def search(query: str) -> List[Result]:\r\n    # ... 200 lines of optimization code\r\n```\r\n\r\n**✅ What Should Happen**\r\n\r\n```\r\n\"Make the search faster\" could mean:\r\n\r\n1. **Faster response time** (< 100ms instead of 500ms)\r\n   - Add database indexes\r\n   - Cache frequent queries\r\n   - Estimated effort: 2 hours\r\n\r\n2. **Handle more concurrent searches** (throughput)\r\n   - Add async/await\r\n   - Connection pooling\r\n   - Estimated effort: 4 hours\r\n\r\n3. **Faster perceived speed** (UX)\r\n   - Show partial results immediately\r\n   - Progressive loading\r\n   - Estimated effort: 3 hours\r\n\r\nCurrent search takes ~500ms for typical queries. \r\nWhich aspect matters most for your use case?\r\n```\r\n\r\n---\r\n\r\n## 2. Simplicity First\r\n\r\n### Example 1: Over-abstraction\r\n\r\n**User Request:** \"Add a function to calculate discount\"\r\n\r\n**❌ What LLMs Do (Overengineered)**\r\n\r\n```python\r\nfrom abc import ABC, abstractmethod\r\nfrom enum import Enum\r\nfrom typing import Protocol, Union\r\nfrom dataclasses import dataclass\r\n\r\nclass DiscountStrategy(ABC):\r\n    @abstractmethod\r\n    def calculate(self, amount: float) -> float:\r\n        pass\r\n\r\nclass PercentageDiscount(DiscountStrategy):\r\n    def __init__(self, percentage: float):\r\n        self.percentage = percentage\r\n    \r\n    def calculate(self, amount: float) -> float:\r\n        return amount * (self.percentage / 100)\r\n\r\nclass FixedDiscount(DiscountStrategy):\r\n    def __init__(self, fixed_amount: float):\r\n        self.fixed_amount = fixed_amount\r\n    \r\n    def calculate(self, amount: float) -> float:\r\n        return min(self.fixed_amount, amount)\r\n\r\n@dataclass\r\nclass DiscountConfig:\r\n    strategy: DiscountStrategy\r\n    min_purchase: float = 0.0\r\n    max_discount: float = float('inf')\r\n\r\nclass DiscountCalculator:\r\n    def __init__(self, config: DiscountConfig):\r\n        self.config = config\r\n    \r\n    def apply_discount(self, amount: float) -> float:\r\n        if amount < self.config.min_purchase:\r\n            return 0\r\n        discount = self.config.strategy.calculate(amount)\r\n        return min(discount, self.config.max_discount)\r\n\r\n# Usage requires 30+ lines of setup for a simple calculation\r\n```\r\n\r\n**✅ What Should Happen (Simple)**\r\n\r\n```python\r\ndef calculate_discount(amount: float, percent: float) -> float:\r\n    \"\"\"Calculate discount amount. percent should be 0-100.\"\"\"\r\n    return amount * (percent / 100)\r\n\r\n# Usage\r\ndiscount = calculate_discount(100.0, 10.0)  # $10 off\r\n```\r\n\r\n**When to add complexity:** Only when you actually need multiple discount types. If that requirement comes later, refactor then.\r\n\r\n### Example 2: Speculative Features\r\n\r\n**User Request:** \"Save user preferences to database\"\r\n\r\n**❌ What LLMs Do (Unnecessary Features)**\r\n\r\n```python\r\nclass PreferenceManager:\r\n    def __init__(self, db, cache=None, validator=None):\r\n        self.db = db\r\n        self.cache = cache or InMemoryCache()\r\n        self.validator = validator or DefaultValidator()\r\n    \r\n    def save(self, user_id: int, prefs: dict, \r\n             merge: bool = True, \r\n             validate: bool = True,\r\n             notify: bool = False) -> bool:\r\n        \"\"\"Save preferences with optional merging, validation, and notifications.\"\"\"\r\n        \r\n        if validate:\r\n            errors = self.validator.validate(prefs)\r\n            if errors:\r\n                raise ValidationError(errors)\r\n        \r\n        existing = self.get(user_id) if merge else {}\r\n        \r\n        if merge:\r\n            existing.update(prefs)\r\n            prefs = existing\r\n        \r\n        self.db.execute(\r\n            \"UPDATE users SET preferences = ? WHERE id = ?\",\r\n            (json.dumps(prefs), user_id)\r\n        )\r\n        \r\n        if self.cache:\r\n            self.cache.set(f\"prefs:{user_id}\", prefs)\r\n        \r\n        if notify:\r\n            self.notify_preference_change(user_id, prefs)\r\n        \r\n        return True\r\n    \r\n    def notify_preference_change(self, user_id: int, prefs: dict):\r\n        # Another 30 lines for a feature nobody asked for\r\n        pass\r\n```\r\n\r\n**✅ What Should Happen (Just What Was Asked)**\r\n\r\n```python\r\ndef save_preferences(db, user_id: int, preferences: dict):\r\n    \"\"\"Save user preferences to database.\"\"\"\r\n    db.execute(\r\n        \"UPDATE users SET preferences = ? WHERE id = ?\",\r\n        (json.dumps(preferences), user_id)\r\n    )\r\n```\r\n\r\n**Add later if needed:** Caching (when performance matters), validation (when bad data appears), merging (when requirement emerges).\r\n\r\n---\r\n\r\n## 3. Surgical Changes\r\n\r\n### Example 1: Drive-by Refactoring\r\n\r\n**User Request:** \"Fix the bug where empty emails crash the validator\"\r\n\r\n**❌ What LLMs Do (Too Much)**\r\n\r\n```diff\r\n  def validate_user(user_data):\r\n-     # Check email format\r\n-     if not user_data.get('email'):\r\n+     \"\"\"Validate user data.\"\"\"\r\n+     email = user_data.get('email', '').strip()\r\n+     \r\n+     # Validate email\r\n+     if not email:\r\n          raise ValueError(\"Email required\")\r\n-     \r\n-     # Basic email validation\r\n-     if '@' not in user_data['email']:\r\n+     if '@' not in email or '.' not in email.split('@')[1]:\r\n          raise ValueError(\"Invalid email\")\r\n      \r\n-     # Check username\r\n-     if not user_data.get('username'):\r\n+     # Validate username\r\n+     username = user_data.get('username', '').strip()\r\n+     if not username:\r\n          raise ValueError(\"Username required\")\r\n+     if len(username) < 3:\r\n+         raise ValueError(\"Username too short\")\r\n+     if not username.isalnum():\r\n+         raise ValueError(\"Username must be alphanumeric\")\r\n      \r\n      return True\r\n```\r\n\r\n**Problems:**\r\n- \"Improved\" email validation beyond the bug fix\r\n- Added username validation nobody asked for\r\n- Changed comments\r\n- Added docstring\r\n\r\n**✅ What Should Happen (Surgical)**\r\n\r\n```diff\r\n  def validate_user(user_data):\r\n      # Check email format\r\n-     if not user_data.get('email'):\r\n+     email = user_data.get('email', '')\r\n+     if not email or not email.strip():\r\n          raise ValueError(\"Email required\")\r\n      \r\n      # Basic email validation\r\n-     if '@' not in user_data['email']:\r\n+     if '@' not in email:\r\n          raise ValueError(\"Invalid email\")\r\n      \r\n      # Check username\r\n      if not user_data.get('username'):\r\n          raise ValueError(\"Username required\")\r\n      \r\n      return True\r\n```\r\n\r\n**Only changed:** The specific lines that fix empty email handling.\r\n\r\n### Example 2: Style Drift\r\n\r\n**User Request:** \"Add logging to the upload function\"\r\n\r\n**❌ What LLMs Do (Reformat Everything)**\r\n\r\n```diff\r\n- def upload_file(file_path, destination):\r\n+ def upload_file(file_path: str, destination: str) -> bool:\r\n+     \"\"\"Upload file to destination with logging.\"\"\"\r\n+     logger.info(f\"Uploading {file_path} to {destination}\")\r\n+     \r\n      try:\r\n-         with open(file_path, 'rb') as f:\r\n-             data = f.read()\r\n-         \r\n-         response = requests.post(destination, files={'file': data})\r\n-         \r\n-         if response.status_code == 200:\r\n-             return True\r\n-         else:\r\n-             return False\r\n+         with open(file_path, \"rb\") as f:\r\n+             data = f.read()\r\n+         response = requests.post(destination, files={\"file\": data})\r\n+         success = response.status_code == 200\r\n+         \r\n+         if success:\r\n+             logger.info(f\"Upload successful: {file_path}\")\r\n+         else:\r\n+             logger.error(f\"Upload failed: {file_path}, status={response.status_code}\")\r\n+         \r\n+         return success\r\n      except Exception as e:\r\n-         print(f\"Error: {e}\")\r\n+         logger.exception(f\"Upload error for {file_path}: {e}\")\r\n          return False\r\n```\r\n\r\n**Problems:**\r\n- Changed quote style ('' to \"\")\r\n- Added type hints nobody asked for\r\n- Added docstring\r\n- Reformatted whitespace\r\n- Changed boolean return logic\r\n\r\n**✅ What Should Happen (Match Existing Style)**\r\n\r\n```diff\r\n+ import logging\r\n+ \r\n+ logger = logging.getLogger(__name__)\r\n+ \r\n  def upload_file(file_path, destination):\r\n+     logger.info(f'Starting upload: {file_path}')\r\n      try:\r\n          with open(file_path, 'rb') as f:\r\n              data = f.read()\r\n          \r\n          response = requests.post(destination, files={'file': data})\r\n          \r\n          if response.status_code == 200:\r\n+             logger.info(f'Upload successful: {file_path}')\r\n              return True\r\n          else:\r\n+             logger.error(f'Upload failed: {file_path}, status={response.status_code}')\r\n              return False\r\n      except Exception as e:\r\n-         print(f\"Error: {e}\")\r\n+         logger.exception(f'Upload error: {file_path}')\r\n          return False\r\n```\r\n\r\n**Matched:** Single quotes, no type hints, existing boolean pattern, spacing style.\r\n\r\n---\r\n\r\n## 4. Goal-Driven Execution\r\n\r\n### Example 1: Vague vs. Verifiable\r\n\r\n**User Request:** \"Fix the authentication system\"\r\n\r\n**❌ What LLMs Do (Vague Approach)**\r\n\r\n```\r\nI'll fix the authentication system by:\r\n1. Reviewing the code\r\n2. Identifying issues\r\n3. Making improvements\r\n4. Testing the changes\r\n\r\n[Proceeds to make changes without clear success criteria]\r\n```\r\n\r\n**✅ What Should Happen (Verifiable Goals)**\r\n\r\n```\r\nTo \"fix authentication,\" I need to define success criteria. \r\nWhat specific issue are we solving?\r\n\r\nIf the issue is \"users stay logged in after password change\":\r\n\r\nPlan:\r\n1. Write test: Change password → verify old session invalidated\r\n   Verify: Test fails (reproduces bug)\r\n\r\n2. Implement: Invalidate sessions on password change\r\n   Verify: Test passes\r\n\r\n3. Check edge cases: Multiple active sessions, concurrent changes\r\n   Verify: Additional tests pass\r\n\r\n4. Verify no regression: Existing auth tests still pass\r\n   Verify: Full test suite green\r\n\r\nCurrent test coverage for auth: [shows coverage]\r\nWhat's the specific auth issue you're seeing?\r\n```\r\n\r\n### Example 2: Multi-Step with Verification\r\n\r\n**User Request:** \"Add rate limiting to the API\"\r\n\r\n**❌ What LLMs Do (All at Once)**\r\n\r\n```python\r\n# Implements full rate limiting with Redis, multiple strategies,\r\n# configuration system, and monitoring in one 300-line commit\r\n# No clear verification steps\r\n```\r\n\r\n**✅ What Should Happen (Incremental with Verification)**\r\n\r\n```\r\nPlan for rate limiting:\r\n\r\n1. Add basic in-memory rate limiting (single endpoint)\r\n   Verify: \r\n   - Test: 100 requests → first 10 succeed, rest get 429\r\n   - Manual: curl endpoint 11 times, see rate limit error\r\n\r\n2. Extract to middleware (apply to all endpoints)\r\n   Verify:\r\n   - Test: Rate limits apply to /users and /posts\r\n   - Existing endpoint tests still pass\r\n\r\n3. Add Redis backend (for multi-server)\r\n   Verify:\r\n   - Test: Rate limit persists across app restarts\r\n   - Test: Two app instances share rate limit counter\r\n\r\n4. Add configuration (rates per endpoint)\r\n   Verify:\r\n   - Test: /search allows 10/min, /users allows 100/min\r\n   - Config file parsed correctly\r\n\r\nEach step is independently verifiable and deployable.\r\nStart with step 1?\r\n```\r\n\r\n### Example 3: Test-First Verification\r\n\r\n**User Request:** \"The sorting breaks when there are duplicate scores\"\r\n\r\n**❌ What LLMs Do (Fix Without Reproducing)**\r\n\r\n```python\r\n# Immediately changes sort logic without confirming the bug\r\ndef sort_scores(scores):\r\n    return sorted(scores, key=lambda x: (-x['score'], x['name']))\r\n```\r\n\r\n**✅ What Should Happen (Reproduce First)**\r\n\r\n```python\r\n# 1. First, write a test that reproduces the issue\r\ndef test_sort_with_duplicate_scores():\r\n    \"\"\"Test sorting when multiple items have same score.\"\"\"\r\n    scores = [\r\n        {'name': 'Alice', 'score': 100},\r\n        {'name': 'Bob', 'score': 100},\r\n        {'name': 'Charlie', 'score': 90},\r\n    ]\r\n    \r\n    result = sort_scores(scores)\r\n    \r\n    # The bug: order is non-deterministic for duplicates\r\n    # Run this test multiple times, it should be consistent\r\n    assert result[0]['score'] == 100\r\n    assert result[1]['score'] == 100\r\n    assert result[2]['score'] == 90\r\n\r\n# Verify: Run test 10 times → fails with inconsistent ordering\r\n\r\n# 2. Now fix with stable sort\r\ndef sort_scores(scores):\r\n    \"\"\"Sort by score descending, then name ascending for ties.\"\"\"\r\n    return sorted(scores, key=lambda x: (-x['score'], x['name']))\r\n\r\n# Verify: Test passes consistently\r\n```\r\n\r\n---\r\n\r\n## Anti-Patterns Summary\r\n\r\n| Principle | Anti-Pattern | Fix |\r\n|-----------|-------------|-----|\r\n| Think Before Coding | Silently assumes file format, fields, scope | List assumptions explicitly, ask for clarification |\r\n| Simplicity First | Strategy pattern for single discount calculation | One function until complexity is actually needed |\r\n| Surgical Changes | Reformats quotes, adds type hints while fixing bug | Only change lines that fix the reported issue |\r\n| Goal-Driven | \"I'll review and improve the code\" | \"Write test for bug X → make it pass → verify no regressions\" |\r\n\r\n## Key Insight\r\n\r\nThe \"overcomplicated\" examples aren't obviously wrong—they follow design patterns and best practices. The problem is **timing**: they add complexity before it's needed, which:\r\n\r\n- Makes code harder to understand\r\n- Introduces more bugs\r\n- Takes longer to implement\r\n- Harder to test\r\n\r\nThe \"simple\" versions are:\r\n- Easier to understand\r\n- Faster to implement\r\n- Easier to test\r\n- Can be refactored later when complexity is actually needed\r\n\r\n**Good code is code that solves today's problem simply, not tomorrow's problem prematurely.**\n\nFile v1.0.0:README.zh.md\n\n# Karpathy 启发的 Agent Skills\r\n\r\n面向 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Aider、GitHub Copilot、OpenClaw、Warp、Windsurf、Cline 以及 SwarmVault/SwarmClaw agent 矩阵的 Karpathy 风格编码智能体指南。\r\n\r\n规范来源是 [`skills/karpathy-guidelines/SKILL.md`](skills/karpathy-guidelines/SKILL.md)。其他 agent 专用文件都生成在 [`adapters/`](adapters/) 下，避免根目录被大量隐藏目录占满。\r\n\r\n[English](./README.md) | 简体中文\r\n\r\n## 解决什么问题\r\n\r\n这些规则针对 Andrej Karpathy 提到的常见 LLM 编码问题：\r\n\r\n| 原则 | 避免的问题 |\r\n| --- | --- |\r\n| 编码前思考 | 静默假设、隐藏困惑、缺少权衡 |\r\n| 简洁优先 | 过度工程、臃肿抽象、未要求的功能 |\r\n| 精准修改 | 顺手重构、无关清理、意外行为变化 |\r\n| 目标驱动执行 | 成功标准模糊、修改后未验证 |\r\n\r\n## 快速安装\r\n\r\n通过 npm 直接运行安装器：\r\n\r\n```bash\r\nnpx @swarmclawai/andrej-karpathy-skills --list\r\nnpx @swarmclawai/andrej-karpathy-skills --agent codex --dest /path/to/project\r\n```\r\n\r\n也可以全局安装：\r\n\r\n```bash\r\nnpm install -g @swarmclawai/andrej-karpathy-skills\r\nandrej-karpathy-skills --agent cursor --dest /path/to/project\r\n```\r\n\r\nCLI 会从 npm 包里的 `adapters/<agent-id>/...` 复制到目标项目中 agent 实际读取的位置。\r\n\r\n## Clone 安装\r\n\r\n```bash\r\ngit clone https://github.com/swarmclawai/andrej-karpathy-skills.git\r\ncd andrej-karpathy-skills\r\nnode scripts/install.mjs --list\r\nnode scripts/install.mjs --agent codex --dest /path/to/project\r\n```\r\n\r\n如需覆盖已有规则文件，加入 `--force`：\r\n\r\n```bash\r\nnode scripts/install.mjs --agent claude --dest /path/to/project --force\r\nnode scripts/install.mjs --agent openclaw --dest /path/to/project --force\r\n```\r\n\r\n部分 agent 支持用户级 skill 目录，可加入 `--global`：\r\n\r\n```bash\r\nnode scripts/install.mjs --agent claude --global --force\r\nnode scripts/install.mjs --agent hermes --global --force\r\n```\r\n\r\n## Adapter 布局\r\n\r\n如果只想手动复制一个文件，请从 adapter source 复制到目标项目里的 install target：\r\n\r\n| Agent | Adapter source | Install target |\r\n| --- | --- |\r\n| Codex | `adapters/codex/AGENTS.md` | `AGENTS.md` |\r\n| Claude Code | `adapters/claude/CLAUDE.md` | `CLAUDE.md` |\r\n| Cursor | `adapters/cursor/.cursor/rules/karpathy-guidelines.mdc` | `.cursor/rules/karpathy-guidelines.mdc` |\r\n| Gemini CLI | `adapters/gemini/GEMINI.md` | `GEMINI.md` |\r\n| Aider | `adapters/aider/CONVENTIONS.md` | `CONVENTIONS.md` |\r\n| GitHub Copilot | `adapters/copilot/.github/copilot-instructions.md` | `.github/copilot-instructions.md` |\r\n| OpenClaw | `adapters/openclaw/.openclaw/skills/karpathy-guidelines/SKILL.md` | `.openclaw/skills/karpathy-guidelines/SKILL.md` |\r\n| Warp / 通用 Agent Skills | `adapters/warp/.agents/skills/karpathy-guidelines/SKILL.md` | `.agents/skills/karpathy-guidelines/SKILL.md` |\r\n| Windsurf | `adapters/windsurf/.windsurfrules` | `.windsurfrules` |\r\n\r\n完整矩阵见 [`install/targets.json`](install/targets.json)，调研说明见 [`docs/agent-compatibility.md`](docs/agent-compatibility.md)。\r\n\r\n## 维护方式\r\n\r\n只编辑规范来源，然后重新生成：\r\n\r\n```bash\r\nnpm run generate\r\nnpm run verify\r\n```\r\n\r\n生成的 adapter 文件都位于 `adapters/<agent-id>/` 下，顶部会标明来源。不要直接修改生成文件。\r\n\r\n## 署名\r\n\r\n本仓库基于原始项目 [`forrestchang/andrej-karpathy-skills`](https://github.com/forrestchang/andrej-karpathy-skills)，并保留 MIT 许可署名。\r\n\r\n## 许可\r\n\r\nMIT\n\nFile v1.0.0:skill-card.md\n\n## Description:\n\nBehavioral guidelines to reduce common LLM coding mistakes when writing, reviewing, or refactoring code.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[sg345662365-oss](https://clawhub.ai/user/sg345662365-oss)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and coding agents use this skill to keep code changes simple, scoped, explicit about assumptions, and tied to verifiable success criteria.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The documentation suggests unpinned npx and global npm installer commands, while the executable installer script is not present in the reviewed artifact.\n\nMitigation: Review the files being installed, pin and verify the npm package version, and inspect the installer script before running it in sensitive environments.\n\nRisk: The guidance intentionally biases agents toward caution, which can slow trivial coding tasks or add unnecessary clarification steps.\n\nMitigation: Apply the skill with judgment for small, low-risk edits and keep success criteria proportional to the task.\n\n## Reference(s):\n\n- [Andrej Karpathy observation on LLM coding pitfalls](https://x.com/karpathy/status/2015883857489522876)\n- [ClawHub skill listing](https://clawhub.ai/sg345662365-oss/skills/andrej-karpathy-skills)\n\n## Skill Output:\n\n**Output Type(s):** [guidance, text, markdown, code, shell commands]\n\n**Output Format:** [Markdown guidance with optional code and shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Agent behavior guidance only; no API calls, credentials, or MCP tools are required by the skill instructions.]\n\n## Skill Version(s):\n\n1.0.0 (source: server release metadata and package.json)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.0:install/targets.json\n\n{\r\n  \"schemaVersion\": 1,\r\n  \"repository\": \"swarmclawai/andrej-karpathy-skills\",\r\n  \"canonicalSkill\": \"skills/karpathy-guidelines/SKILL.md\",\r\n  \"generatedBy\": \"scripts/generate.mjs\",\r\n  \"description\": \"Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.\",\r\n  \"agents\": [\r\n    {\r\n      \"id\": \"codex\",\r\n      \"name\": \"OpenAI Codex\",\r\n      \"aliases\": [\r\n        \"codex-cli\"\r\n      ],\r\n      \"summary\": \"Uses root AGENTS.md project instructions.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"AGENTS.md\",\r\n          \"source\": \"adapters/codex/AGENTS.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"claude\",\r\n      \"name\": \"Claude Code\",\r\n      \"aliases\": [\r\n        \"claude-cli\",\r\n        \"claude-code\"\r\n      ],\r\n      \"summary\": \"Uses CLAUDE.md project memory and Agent Skills folders.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"CLAUDE.md\",\r\n          \"source\": \"adapters/claude/CLAUDE.md\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".claude/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/claude/.claude/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \"~/.claude/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/claude/.claude/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"cursor\",\r\n      \"name\": \"Cursor\",\r\n      \"aliases\": [\r\n        \"cursor-agent\",\r\n        \"cursor-cli\"\r\n      ],\r\n      \"summary\": \"Uses project rules in .cursor/rules.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".cursor/rules/karpathy-guidelines.mdc\",\r\n          \"source\": \"adapters/cursor/.cursor/rules/karpathy-guidelines.mdc\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".cursor/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/cursor/.cursor/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"goose\",\r\n      \"name\": \"Goose\",\r\n      \"aliases\": [],\r\n      \"summary\": \"Uses the shared AGENTS.md convention in SwarmVault.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"AGENTS.md\",\r\n          \"source\": \"adapters/goose/AGENTS.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"pi\",\r\n      \"name\": \"Pi\",\r\n      \"aliases\": [],\r\n      \"summary\": \"Uses the shared AGENTS.md convention in SwarmVault.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"AGENTS.md\",\r\n          \"source\": \"adapters/pi/AGENTS.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"gemini\",\r\n      \"name\": \"Gemini CLI\",\r\n      \"aliases\": [\r\n        \"gemini-cli\"\r\n      ],\r\n      \"summary\": \"Uses GEMINI.md context files.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"GEMINI.md\",\r\n          \"source\": \"adapters/gemini/GEMINI.md\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".gemini/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/gemini/.gemini/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"opencode\",\r\n      \"name\": \"OpenCode\",\r\n      \"aliases\": [\r\n        \"opencode-cli\"\r\n      ],\r\n      \"summary\": \"Uses AGENTS.md rules and native Agent Skills folders.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"AGENTS.md\",\r\n          \"source\": \"adapters/opencode/AGENTS.md\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".opencode/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/opencode/.opencode/skills/karpathy-guidelines/SKILL.md\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".agents/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/opencode/.agents/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"aider\",\r\n      \"name\": \"Aider\",\r\n      \"aliases\": [\r\n        \"aider-cli\"\r\n      ],\r\n      \"summary\": \"Uses CONVENTIONS.md via --read or .aider.conf.yml.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"CONVENTIONS.md\",\r\n          \"source\": \"adapters/aider/CONVENTIONS.md\"\r\n        },\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".aider.conf.yml\",\r\n          \"source\": \"adapters/aider/.aider.conf.yml\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"copilot\",\r\n      \"name\": \"GitHub Copilot\",\r\n      \"aliases\": [\r\n        \"copilot-cli\"\r\n      ],\r\n      \"summary\": \"Uses repository custom instructions and AGENTS.md agent instructions.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".github/copilot-instructions.md\",\r\n          \"source\": \"adapters/copilot/.github/copilot-instructions.md\"\r\n        },\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"AGENTS.md\",\r\n          \"source\": \"adapters/copilot/AGENTS.md\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".copilot/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/copilot/.copilot/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"trae\",\r\n      \"name\": \"Trae\",\r\n      \"aliases\": [\r\n        \"trae-cli\"\r\n      ],\r\n      \"summary\": \"Uses project rules in .trae/rules.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".trae/rules/karpathy-guidelines.md\",\r\n          \"source\": \"adapters/trae/.trae/rules/karpathy-guidelines.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"claw\",\r\n      \"name\": \"Claw\",\r\n      \"aliases\": [\r\n        \"openclaw-legacy\"\r\n      ],\r\n      \"summary\": \"Uses a Claw/OpenClaw compatible skill folder.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".claw/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/claw/.claw/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"droid\",\r\n      \"name\": \"Factory Droid\",\r\n      \"aliases\": [\r\n        \"droid-cli\"\r\n      ],\r\n      \"summary\": \"Uses Factory project rules in .factory/rules.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".factory/rules/karpathy-guidelines.md\",\r\n          \"source\": \"adapters/droid/.factory/rules/karpathy-guidelines.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"kiro\",\r\n      \"name\": \"Kiro\",\r\n      \"aliases\": [\r\n        \"kiro-cli\"\r\n      ],\r\n      \"summary\": \"Uses steering files and skill folders.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".kiro/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/kiro/.kiro/skills/karpathy-guidelines/SKILL.md\"\r\n        },\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".kiro/steering/karpathy-guidelines.md\",\r\n          \"source\": \"adapters/kiro/.kiro/steering/karpathy-guidelines.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"hermes\",\r\n      \"name\": \"Hermes\",\r\n      \"aliases\": [\r\n        \"hermes-agent\"\r\n      ],\r\n      \"summary\": \"Uses AGENTS.md plus a user-level Hermes skill.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"AGENTS.md\",\r\n          \"source\": \"adapters/hermes/AGENTS.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \"~/.hermes/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/hermes/.hermes/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"antigravity\",\r\n      \"name\": \"Antigravity\",\r\n      \"aliases\": [],\r\n      \"summary\": \"Uses .agents rules and workflows.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".agents/rules/karpathy-guidelines.md\",\r\n          \"source\": \"adapters/antigravity/.agents/rules/karpathy-guidelines.md\"\r\n        },\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".agents/workflows/karpathy-guidelines.md\",\r\n          \"source\": \"adapters/antigravity/.agents/workflows/karpathy-guidelines.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"vscode\",\r\n      \"name\": \"VS Code Copilot Chat\",\r\n      \"aliases\": [\r\n        \"github-copilot-chat\"\r\n      ],\r\n      \"summary\": \"Uses Copilot instructions and chat modes.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".github/copilot-instructions.md\",\r\n          \"source\": \"adapters/vscode/.github/copilot-instructions.md\"\r\n        },\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".github/chatmodes/karpathy-guidelines.chatmode.md\",\r\n          \"source\": \"adapters/vscode/.github/chatmodes/karpathy-guidelines.chatmode.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"windsurf\",\r\n      \"name\": \"Windsurf Rules\",\r\n      \"aliases\": [\r\n        \"windsurf-cli\"\r\n      ],\r\n      \"summary\": \"Uses a .windsurfrules file and the Windsurf skill path.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".windsurfrules\",\r\n          \"source\": \"adapters/windsurf/.windsurfrules\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".codeium/windsurf/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/windsurf/.codeium/windsurf/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"cline\",\r\n      \"name\": \"Cline Rules\",\r\n      \"aliases\": [\r\n        \"cline-cli\"\r\n      ],\r\n      \"summary\": \"Uses .clinerules and also supports AGENTS.md.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \".clinerules/karpathy-guidelines.md\",\r\n          \"source\": \"adapters/cline/.clinerules/karpathy-guidelines.md\"\r\n        },\r\n        {\r\n          \"kind\": \"file\",\r\n          \"target\": \"AGENTS.md\",\r\n          \"source\": \"adapters/cline/AGENTS.md\"\r\n        },\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".agents/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/cline/.agents/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"amp\",\r\n      \"name\": \"Amp\",\r\n      \"aliases\": [\r\n        \"amp-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .config/agents/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".config/agents/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/amp/.config/agents/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"augment\",\r\n      \"name\": \"Augment\",\r\n      \"aliases\": [\r\n        \"augment-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .augment/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".augment/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/augment/.augment/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"adal\",\r\n      \"name\": \"AdaL\",\r\n      \"aliases\": [\r\n        \"adal-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .adal/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".adal/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/adal/.adal/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"bob\",\r\n      \"name\": \"Bob\",\r\n      \"aliases\": [\r\n        \"bob-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .bob/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".bob/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/bob/.bob/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"codebuddy\",\r\n      \"name\": \"CodeBuddy\",\r\n      \"aliases\": [\r\n        \"codebuddy-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .codebuddy/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".codebuddy/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/codebuddy/.codebuddy/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"command-code\",\r\n      \"name\": \"Command Code\",\r\n      \"aliases\": [\r\n        \"command-code-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .commandcode/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".commandcode/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/command-code/.commandcode/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"continue\",\r\n      \"name\": \"Continue\",\r\n      \"aliases\": [\r\n        \"continue-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .continue/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".continue/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/continue/.continue/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"cortex\",\r\n      \"name\": \"Cortex\",\r\n      \"aliases\": [\r\n        \"cortex-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .snowflake/cortex/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".snowflake/cortex/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/cortex/.snowflake/cortex/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"crush\",\r\n      \"name\": \"Crush\",\r\n      \"aliases\": [\r\n        \"crush-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .config/crush/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".config/crush/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/crush/.config/crush/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"deepagents\",\r\n      \"name\": \"Deep Agents\",\r\n      \"aliases\": [\r\n        \"deepagents-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .deepagents/agent/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".deepagents/agent/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/deepagents/.deepagents/agent/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"firebender\",\r\n      \"name\": \"Firebender\",\r\n      \"aliases\": [\r\n        \"firebender-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .firebender/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".firebender/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/firebender/.firebender/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"iflow\",\r\n      \"name\": \"iFlow\",\r\n      \"aliases\": [\r\n        \"iflow-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .iflow/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".iflow/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/iflow/.iflow/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"junie\",\r\n      \"name\": \"Junie\",\r\n      \"aliases\": [\r\n        \"junie-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .junie/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".junie/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/junie/.junie/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"kilo-code\",\r\n      \"name\": \"Kilo Code\",\r\n      \"aliases\": [\r\n        \"kilo-code-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .kilocode/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".kilocode/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/kilo-code/.kilocode/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"kimi\",\r\n      \"name\": \"Kimi\",\r\n      \"aliases\": [\r\n        \"kimi-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .config/agents/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".config/agents/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/kimi/.config/agents/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"kode\",\r\n      \"name\": \"Kode\",\r\n      \"aliases\": [\r\n        \"kode-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .kode/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".kode/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/kode/.kode/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"mcpjam\",\r\n      \"name\": \"MCPJam\",\r\n      \"aliases\": [\r\n        \"mcpjam-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .mcpjam/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".mcpjam/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/mcpjam/.mcpjam/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"mistral-vibe\",\r\n      \"name\": \"Mistral Vibe\",\r\n      \"aliases\": [\r\n        \"mistral-vibe-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .vibe/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".vibe/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/mistral-vibe/.vibe/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"mux\",\r\n      \"name\": \"Mux\",\r\n      \"aliases\": [\r\n        \"mux-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .mux/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".mux/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/mux/.mux/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"neovate\",\r\n      \"name\": \"Neovate\",\r\n      \"aliases\": [\r\n        \"neovate-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .neovate/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".neovate/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/neovate/.neovate/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"openclaw\",\r\n      \"name\": \"OpenClaw\",\r\n      \"aliases\": [\r\n        \"openclaw-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .openclaw/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".openclaw/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/openclaw/.openclaw/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"openhands\",\r\n      \"name\": \"OpenHands\",\r\n      \"aliases\": [\r\n        \"openhands-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .openhands/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".openhands/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/openhands/.openhands/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"pochi\",\r\n      \"name\": \"Pochi\",\r\n      \"aliases\": [\r\n        \"pochi-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .pochi/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".pochi/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/pochi/.pochi/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"qoder\",\r\n      \"name\": \"Qoder\",\r\n      \"aliases\": [\r\n        \"qoder-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .qoder/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".qoder/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/qoder/.qoder/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"qwen-code\",\r\n      \"name\": \"Qwen Code\",\r\n      \"aliases\": [\r\n        \"qwen-code-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .qwen/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".qwen/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/qwen-code/.qwen/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"replit\",\r\n      \"name\": \"Replit\",\r\n      \"aliases\": [\r\n        \"replit-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .config/agents/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".config/agents/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/replit/.config/agents/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"roo-code\",\r\n      \"name\": \"Roo Code\",\r\n      \"aliases\": [\r\n        \"roo-code-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .roo/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".roo/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/roo-code/.roo/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"trae-cn\",\r\n      \"name\": \"TRAE CN\",\r\n      \"aliases\": [\r\n        \"trae-cn-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .trae-cn/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".trae-cn/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/trae-cn/.trae-cn/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"warp\",\r\n      \"name\": \"Warp\",\r\n      \"aliases\": [\r\n        \"warp-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .agents/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".agents/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/warp/.agents/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    },\r\n    {\r\n      \"id\": \"zencoder\",\r\n      \"name\": \"Zencoder\",\r\n      \"aliases\": [\r\n        \"zencoder-cli\"\r\n      ],\r\n      \"summary\": \"Uses an Agent Skills bundle under .zencoder/skills.\",\r\n      \"paths\": [\r\n        {\r\n          \"kind\": \"skill\",\r\n          \"target\": \".zencoder/skills/karpathy-guidelines/SKILL.md\",\r\n          \"source\": \"adapters/zencoder/.zencoder/skills/karpathy-guidelines/SKILL.md\"\r\n        }\r\n      ],\r\n      \"globalPaths\": []\r\n    }\r\n  ],\r\n  \"sources\": [\r\n    {\r\n      \"id\": \"agents-md\",\r\n      \"title\": \"AGENTS.md open format\",\r\n      \"url\": \"https://agents.md/\",\r\n      \"appliesTo\": [\r\n        \"codex\",\r\n        \"opencode\",\r\n        \"copilot\",\r\n        \"goose\",\r\n        \"pi\",\r\n        \"cline\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"openai-codex\",\r\n      \"title\": \"OpenAI Codex AGENTS.md guidance\",\r\n      \"url\": \"https://openai.com/index/introducing-codex/\",\r\n      \"appliesTo\": [\r\n        \"codex\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"claude-memory\",\r\n      \"title\": \"Claude Code memory files\",\r\n      \"url\": \"https://docs.claude.com/en/docs/claude-code/memory\",\r\n      \"appliesTo\": [\r\n        \"claude\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"claude-skills\",\r\n      \"title\": \"Claude Code Agent Skills\",\r\n      \"url\": \"https://docs.claude.com/en/docs/claude-code/skills\",\r\n      \"appliesTo\": [\r\n        \"claude\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"cursor-rules\",\r\n      \"title\": \"Cursor project rules\",\r\n      \"url\": \"https://docs.cursor.com/context/rules\",\r\n      \"appliesTo\": [\r\n        \"cursor\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"gemini-md\",\r\n      \"title\": \"Gemini CLI GEMINI.md files\",\r\n      \"url\": \"https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/gemini-md.md\",\r\n      \"appliesTo\": [\r\n        \"gemini\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"copilot-instructions\",\r\n      \"title\": \"GitHub Copilot repository custom instructions\",\r\n      \"url\": \"https://docs.github.com/en/copilot/how-tos/custom-instructions/adding-repository-custom-instructions-for-github-copilot\",\r\n      \"appliesTo\": [\r\n        \"copilot\",\r\n        \"vscode\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"opencode-rules\",\r\n      \"title\": \"OpenCode rules and AGENTS.md\",\r\n      \"url\": \"https://opencode.ai/docs/rules/\",\r\n      \"appliesTo\": [\r\n        \"opencode\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"opencode-skills\",\r\n      \"title\": \"OpenCode Agent Skills\",\r\n      \"url\": \"https://opencode.ai/docs/skills\",\r\n      \"appliesTo\": [\r\n        \"opencode\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"aider-conventions\",\r\n      \"title\": \"Aider coding conventions\",\r\n      \"url\": \"https://aider.chat/docs/usage/conventions.html\",\r\n      \"appliesTo\": [\r\n        \"aider\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"openclaw-skills\",\r\n      \"title\": \"OpenClaw Agent Skills\",\r\n      \"url\": \"https://docs.openclaw.ai/tools/skills\",\r\n      \"appliesTo\": [\r\n        \"openclaw\",\r\n        \"claw\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"kiro-steering\",\r\n      \"title\": \"Kiro steering\",\r\n      \"url\": \"https://kiro.dev/docs/steering/\",\r\n      \"appliesTo\": [\r\n        \"kiro\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"warp-skills\",\r\n      \"title\": \"Warp Agent Skills\",\r\n      \"url\": \"https://docs.warp.dev/agent-platform/capabilities/skills\",\r\n      \"appliesTo\": [\r\n        \"warp\"\r\n      ]\r\n    },\r\n    {\r\n      \"id\": \"cline-rules\",\r\n      \"title\": \"Cline rules\",\r\n      \"url\": \"https://docs.cline.bot/features/cline-rules/overview\",\r\n      \"appliesTo\": [\r\n        \"cline\"\r\n      ]\r\n    }\r\n  ]\r\n}\n\nFile v1.0.0:package.json\n\n{\r\n  \"name\": \"@swarmclawai/andrej-karpathy-skills\",\r\n  \"version\": \"1.0.0\",\r\n  \"type\": \"module\",\r\n  \"description\": \"Karpathy-inspired coding-agent guidelines packaged for many agent runtimes.\",\r\n  \"bin\": {\r\n    \"andrej-karpathy-skills\": \"scripts/install.mjs\",\r\n    \"karpathy-skills\": \"scripts/install.mjs\"\r\n  },\r\n  \"files\": [\r\n    \".claude-plugin\",\r\n    \"adapters\",\r\n    \"docs\",\r\n    \"install\",\r\n    \"scripts\",\r\n    \"skills\",\r\n    \"CURSOR.md\",\r\n    \"EXAMPLES.md\",\r\n    \"README.zh.md\"\r\n  ],\r\n  \"scripts\": {\r\n    \"generate\": \"node scripts/generate.mjs\",\r\n    \"verify\": \"node scripts/verify.mjs\",\r\n    \"pack:dry-run\": \"npm pack --dry-run\"\r\n  },\r\n  \"keywords\": [\r\n    \"agent-skills\",\r\n    \"agents-md\",\r\n    \"coding-agents\",\r\n    \"ai-agents\",\r\n    \"claude-code\",\r\n    \"codex\",\r\n    \"cursor\",\r\n    \"gemini-cli\",\r\n    \"opencode\",\r\n    \"aider\",\r\n    \"copilot\",\r\n    \"openclaw\",\r\n    \"karpathy\"\r\n  ],\r\n  \"repository\": {\r\n    \"type\": \"git\",\r\n    \"url\": \"git+https://github.com/swarmclawai/andrej-karpathy-skills.git\"\r\n  },\r\n  \"bugs\": {\r\n    \"url\": \"https://github.com/swarmclawai/andrej-karpathy-skills/issues\"\r\n  },\r\n  \"homepage\": \"https://github.com/swarmclawai/andrej-karpathy-skills#readme\",\r\n  \"license\": \"MIT\",\r\n  \"engines\": {\r\n    \"node\": \">=18\"\r\n  },\r\n  \"publishConfig\": {\r\n    \"access\": \"public\"\r\n  }\r\n}\n\nFile v1.0.0:LICENSE\n\nMIT License\r\n\r\nCopyright (c) 2026 forrestchang and SwarmClaw AI contributors\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy\r\nof this software and associated documentation files (the \"Software\"), to deal\r\nin the Software without restriction, including without limitation the rights\r\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\ncopies of the Software, and to permit persons to whom the Software is\r\nfurnished to do so, subject to the following conditions:\r\n\r\nThe above copyright notice and this permission notice shall be included in all\r\ncopies or substantial portions of the Software.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\nSOFTWARE.","readmeExcerpt":"Skill: Andrej Karpathy Skills Owner: sg345662365-oss Summary: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-06-08T05:53:11.421Z | auto - Initial release of Karpathy Guidelines for coding with LLMs. - Outlines behavioral principles to avoid common mistakes","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: karpathy-guidelines\r\ndescription: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.\r\n---\r\n\r\n# Karpathy Guidelines\r\n\r\nBehavioral guidelines to reduce common LLM coding mistakes, derived from [Andrej Karpathy's observations](https://x.com/karpathy/status/2015883857489522876) on LLM coding pitfalls.\r\n\r\n**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.\r\n\r\n## 1. Think Before Coding\r\n\r\n**Don't assume. Don't hide confusion. Surface tradeoffs.**\r\n\r\nBefore implementing:\r\n- State your assumptions explicitly. If uncertain, ask.\r\n- If multiple interpretations exist, present them - don't pick silently.\r\n- If a simpler approach exists, say so. Push back when warranted.\r\n- If something is unclear, stop. Name what's confusing. Ask.\r\n\r\n## 2. Simplicity First\r\n\r\n**Minimum code that solves the problem. Nothing speculative.**\r\n\r\n- No features beyond what was asked.\r\n- No abstractions for single-use code.\r\n- No \"flexibility\" or \"configurability\" that wasn't requested.\r\n- No error handling for impossible scenarios.\r\n- If you write 200 lines and it could be 50, rewrite it.\r\n\r\nAsk yourself: \"Would a senior engineer say this is overcomplicated?\" If yes, simplify.\r\n\r\n## 3. Surgical Changes\r\n\r\n**Touch only what you must. Clean up only your own mess.**\r\n\r\nWhen editing existing code:\r\n- Don't \"improve\" adjacent code, comments, or formatting.\r\n- Don't refactor things that aren't broken.\r\n- Match existing style, even if you'd do it differently.\r\n- If you notice unrelated dead code, mention it - don't delete it.\r\n\r\nWhen your changes create orphans:\r\n- Remove imports/variables/functions that YOUR changes made unused.\r\n- Don't remove pre-existing dead code unless asked.\r\n\r\nThe test: Every changed line should trace directly to the user's request.\r\n\r\n## 4. Goal-Driven Execution\r\n\r\n**Define success criteria. Loop until verified.**\r\n\r\nTransform tasks into verifiable goals:\r\n- \"Add validation\" → \"Write tests for invalid inputs, then make them pass\"\r\n- \"Fix the bug\" → \"Write a test that reproduces it, then make it pass\"\r\n- \"Refactor X\" → \"Ensure tests pass before and after\"\r\n\r\nFor multi-step tasks, state a brief plan:\r\n```\r\n1. [Step] → verify: [check]\r\n2. [Step] → verify: [check]\r\n3. [Step] → verify: [check]\r\n```\r\n\r\nStrong success criteria let you loop independently. Weak criteria (\"make it work\") require constant clarification."},{"path":"README.md","content":"# Karpathy-Inspired Agent Skills\r\n\r\nKarpathy-inspired coding-agent guidelines packaged for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Aider, GitHub Copilot, OpenClaw, Warp, Windsurf, Cline, and the wider SwarmVault/SwarmClaw agent matrix.\r\n\r\nThe canonical source is [`skills/karpathy-guidelines/SKILL.md`](skills/karpathy-guidelines/SKILL.md). Agent-specific files are generated under [`adapters/`](adapters/) so the repository root stays readable while every supported tool receives the same behavioral guidance.\r\n\r\nEnglish | [Simplified Chinese](./README.zh.md)\r\n\r\n## What This Adds\r\n\r\nThese guidelines address four common LLM coding failure modes described by Andrej Karpathy:\r\n\r\n| Principle | Prevents |\r\n| --- | --- |\r\n| Think Before Coding | Silent assumptions, hidden confusion, missing tradeoffs |\r\n| Simplicity First | Over-engineering, bloated abstractions, speculative features |\r\n| Surgical Changes | Drive-by rewrites, unrelated cleanup, accidental behavior changes |\r\n| Goal-Driven Execution | Vague completion criteria and unverified changes |\r\n\r\nThe content is intentionally short. It is meant to merge with project-specific instructions, not replace them.\r\n\r\n## Quick Install\r\n\r\nInstall through npm and run the installer with `npx`:\r\n\r\n```bash\r\nnpx @swarmclawai/andrej-karpathy-skills --list\r\nnpx @swarmclawai/andrej-karpathy-skills --agent codex --dest /path/to/project\r\n```\r\n\r\nOr install the CLI globally:\r\n\r\n```bash\r\nnpm install -g @swarmclawai/andrej-karpathy-skills\r\nandrej-karpathy-skills --agent cursor --dest /path/to/project\r\n```\r\n\r\nThe CLI copies the right adapter from the npm package into the destination project.\r\n\r\n## Clone Install\r\n\r\nClone once, then copy the right adapter into any project. The installer reads [`install/targets.json`](install/targets.json), copies from `adapters/<agent-id>/...`, and writes to the real path your agent expects.\r\n\r\n```bash\r\ngit clone https://github.com/swarmclawai/andrej-karpathy-skills.git\r\ncd andrej-karpathy-skills\r\nnode scripts/install.mjs --list\r\nnode scripts/install.mjs --agent codex --dest /path/to/project\r\n```\r\n\r\nUse `--force` if you intentionally want to overwrite an existing instruction file:\r\n\r\n```bash\r\nnode scripts/install.mjs --agent claude --dest /path/to/project --force\r\nnode scripts/install.mjs --agent openclaw --dest /path/to/project --force\r\n```\r\n\r\nUse `--global` for agents with supported user-level skill locations:\r\n\r\n```bash\r\nnode scripts/install.mjs --agent claude --global --force\r\nnode scripts/install.mjs --agent hermes --global --force\r\n```\r\n\r\n## Adapter Layout\r\n\r\nIf you only need one file, copy the adapter source to the install target shown below:\r\n\r\n| Agent | Adapter source | Installs to |\r\n| --- | --- |\r\n| Codex | `adapters/codex/AGENTS.md` | `AGENTS.md` |\r\n| Claude Code | `adapters/claude/CLAUDE.md` | `CLAUDE.md` |\r\n| Cursor | `adapters/cursor/.cursor/rules/karpathy-guidelines.mdc` | `.cursor/rules/karpathy-guidelines.mdc` |\r\n| Gemini CLI | `adapters/gemini/GEMINI.md` | `GEMINI.m"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn795jyrb7x5a08fmcczzxpwy1886a3m\",\n  \"slug\": \"andrej-karpathy-skills\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1780897991421\n}"},{"path":"CURSOR.md","content":"# Using These Guidelines With Cursor\r\n\r\nCursor reads project rules from `.cursor/rules/`. This repository keeps the generated Cursor adapter under [`adapters/cursor/.cursor/rules/karpathy-guidelines.mdc`](adapters/cursor/.cursor/rules/karpathy-guidelines.mdc) so the repo root stays clean.\r\n\r\nInstall it into another project with:\r\n\r\n```bash\r\nnode scripts/install.mjs --agent cursor --dest /path/to/project\r\n```\r\n\r\nThat command copies the adapter to `.cursor/rules/karpathy-guidelines.mdc` in the destination project. The Cursor rule is generated from [`skills/karpathy-guidelines/SKILL.md`](skills/karpathy-guidelines/SKILL.md); edit the canonical skill and run `npm run generate` instead of editing the adapter directly."},{"path":"EXAMPLES.md","content":"# Examples\r\n\r\nReal-world code examples demonstrating the four principles. Each example shows what LLMs commonly do wrong and how to fix it.\r\n\r\n---\r\n\r\n## 1. Think Before Coding\r\n\r\n### Example 1: Hidden Assumptions\r\n\r\n**User Request:** \"Add a feature to export user data\"\r\n\r\n**❌ What LLMs Do (Wrong Assumptions)**\r\n\r\n```python\r\ndef export_users(format='json'):\r\n    \"\"\"Export all users to a file.\"\"\"\r\n    users = User.query.all()\r\n    \r\n    if format == 'json':\r\n        with open('users.json', 'w') as f:\r\n            json.dump([u.to_dict() for u in users], f)\r\n    elif format == 'csv':\r\n        with open('users.csv', 'w') as f:\r\n            writer = csv.DictWriter(f, fieldnames=['id', 'email', 'name'])\r\n            writer.writeheader()\r\n            writer.writerows([u.to_dict() for u in users])\r\n    \r\n    return f\"Exported {len(users)} users\"\r\n```\r\n\r\n**Problems:**\r\n- Assumed it should export ALL users (what about pagination? privacy?)\r\n- Assumed file location without asking\r\n- Assumed which fields to include\r\n- Assumed CSV fieldnames without checking actual data structure\r\n\r\n**✅ What Should Happen (Surface Assumptions)**\r\n\r\n```\r\nBefore implementing, I need to clarify:\r\n\r\n1. **Scope**: Export all users or filtered subset? (privacy implications)\r\n2. **Format**: You mentioned \"export\" - did you mean:\r\n   - Download file in browser?\r\n   - Background job with email notification?\r\n   - API endpoint returning data?\r\n3. **Fields**: Which user fields? (some might be sensitive)\r\n4. **Volume**: How many users typically? (affects approach)\r\n\r\nSimplest approach: Add an API endpoint that returns paginated JSON.\r\nWould need more info for file-based exports.\r\n\r\nWhat's your preference?\r\n```\r\n\r\n### Example 2: Multiple Interpretations\r\n\r\n**User Request:** \"Make the search faster\"\r\n\r\n**❌ What LLMs Do (Pick Silently)**\r\n\r\n```python\r\n# Adds caching, database indexes, and async processing\r\n# without asking which \"faster\" matters\r\n@lru_cache(maxsize=1000)\r\nasync def search(query: str) -> List[Result]:\r\n    # ... 200 lines of optimization code\r\n```\r\n\r\n**✅ What Should Happen**\r\n\r\n```\r\n\"Make the search faster\" could mean:\r\n\r\n1. **Faster response time** (< 100ms instead of 500ms)\r\n   - Add database indexes\r\n   - Cache frequent queries\r\n   - Estimated effort: 2 hours\r\n\r\n2. **Handle more concurrent searches** (throughput)\r\n   - Add async/await\r\n   - Connection pooling\r\n   - Estimated effort: 4 hours\r\n\r\n3. **Faster perceived speed** (UX)\r\n   - Show partial results immediately\r\n   - Progressive loading\r\n   - Estimated effort: 3 hours\r\n\r\nCurrent search takes ~500ms for typical queries. \r\nWhich aspect matters most for your use case?\r\n```\r\n\r\n---\r\n\r\n## 2. Simplicity First\r\n\r\n### Example 1: Over-abstraction\r\n\r\n**User Request:** \"Add a function to calculate discount\"\r\n\r\n**❌ What LLMs Do (Overengineered)**\r\n\r\n```python\r\nfrom abc import ABC, abstractmethod\r\nfrom enum import Enum\r\nfrom typing import Protocol, Union\r\nfrom dataclasses import dataclass\r\n\r\nclass DiscountStrategy(ABC):\r\n    @abstr"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes... Skill: Andrej Karpathy Skills Owner: sg345662365-oss Summary: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-06-08T05:53:11.421Z | auto - Initial release of Karpathy Guidelines for coding with LLMs. - Outlines behavioral principles to avoid common mistakes","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1266,"uniquenessScore":52,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T03:05:57.847Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T03:05:57.847Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T05:39:16.122Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}