mcpField
K
karpathy-guidelines

karpathy-guidelines

github.com/cowork-osAgent workflows51685 installsUpdated today
Repository

About karpathy-guidelines

karpathy-guidelines is a skill for keeping coding and file-editing work focused, minimal, and verifiable. It suits implementation, debugging, review, and refactoring tasks where unrelated changes should be avoided.

Key features

  1. 01Keep task scope focused
  2. 02Prefer minimal relevant changes
  3. 03Verify results
  4. 04Separate unrelated issues
  5. 05State assumptions

Use cases

  1. 01Fix a bug without unrelated refactoring
  2. 02Review a patch for unnecessary complexity
  3. 03Implement a feature and run a relevant test

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cowork-os/cowork-os --skill karpathy-guidelines

After installing, type/karpathy-guidelinesin Claude Code to confirm it loaded.

Details

From the project README

Surgical Task Guidelines

Purpose

Keep execution scoped, simple, and verifiable for coding, debugging, review, refactor, and file-editing tasks.

Routing

  • Use when: Use for coding, debugging, review, refactor, build, test, release, or file-editing tasks where scope control and verification matter.
  • Do not use when: Do not use for pure brainstorming, broad strategy, or requests where the user explicitly asks for expansive ideation rather than execution.
  • Outputs: A focused task result with assumptions, scoped changes, verification evidence, and unrelated issues kept separate.
  • Success criteria: The result satisfies the user's request with minimal relevant changes, no drive-by edits, and clear verification evidence.

Trigger Examples

Positive
  • Use the karpathy-guidelines skill for this request.
  • Fix this bug without refactoring unrelated modules.
  • Review this patch and point out overcomplicated or unnecessary changes.
  • Refactor this file surgically while preserving behavior.
  • Implement this feature and verify the narrowest relevant test passes.
Negative
  • Brainstorm ten moonshot product directions.
  • Write a broad strategy memo with multiple speculative options.
  • Do not use karpathy-guidelines for unrelated requests.
  • This is conceptual discussion only; no tool workflow is needed.

Runtime Prompt

  • Current runtime prompt length: 621 characters.
  • Runtime prompt is defined directly in ../karpathy-guidelines.json.

Comments

Markdown supported