Skip to content
FunCoding

claude-code-dev

How to develop, modify, and extend the Claude Code codebase following its established programming style, patterns, and conventions. Use this skill whenever working on the claude-code source — adding tools, commands, utils, components, types, hooks, services, or fixing bugs. Also use when the user asks about claude-code architecture, coding standards, file organization, or wants to understand how the codebase works. This skill ensures all contributions match the existing codebase style exactly.

Star
2,111
License
MIT
Last commit
Oct 8, 2026

claude-code-skills/SKILL.md

View on GitHub

Claude Code Development Style Guide

This skill captures the programming style, patterns, and conventions used in the Claude Code codebase (@anthropic-ai/claude-code). Each topic below links to a dedicated deep-dive document with comprehensive examples and rules extracted from the actual source.

Summary

Claude Code is an ESM TypeScript Node.js CLI application using Ink (React for terminals) for its UI, esbuild for transpilation, and Bun internally for feature flags and dead code elimination. Key stack: TypeScript, Zod v4, lodash-es, React/Ink, esbuild.

Detailed Guides (Resource Files)

Each topic below is covered in depth in its own resource file within this skill's directory. Read the relevant file before working on that area of the codebase.

#TopicFileSummary
01Project Overview01-project-overview.mdTech stack, build system, runtime environment, key dependencies
02Directory Structure02-directory-structure.mdFull src/ layout, file organization patterns, where things go
03Import Conventions03-import-conventions.md.js extensions, import type, lodash cherry-picks, feature flags, cycle breaking
04Naming Conventions04-naming-conventions.mdcamelCase/PascalCase/UPPER_SNAKE rules, file naming, safety names
05TypeScript Patterns05-typescript-patterns.mdBranded types, discriminated unions, as const, satisfies, Zod schemas, generics
06Commenting Style06-commenting-style.mdJSDoc, why-not-what philosophy, PR references, section headers, lint suppression
07Error Handling07-error-handling.mdCustom error classes, utility functions, graceful degradation, catch conventions
08Function Patterns08-function-patterns.mdbuildTool() factory, memoize, async generators, guard clauses, fire-and-forget
09Tool Architecture09-tool-architecture.mdTool directory structure, buildTool() API, schemas, permissions, UI rendering
10Command Architecture10-command-architecture.mdCommand types, index.ts pattern, lazy loading, registration
11State Management11-state-management.mdModule-level state, getter/setter, AppState threading, cleanup registry
12Testing Conventions12-testing-conventions.mdReset helpers, NODE_ENV guards, test-only exports, deterministic sorting
13Formatting Rules13-formatting-rules.mdNo semicolons, single quotes, trailing commas, indentation, expression style
14Quick References14-quick-references.mdStep-by-step checklists for adding tools, commands, utils, and types

Similar Skills

subagent-driven-development

OBobra/superpowers298k2,631 new stars in the last 7 days

chief-of-staff

MAmattpocock/skills288k10,178 new stars in the last 7 days

setup-matt-pocock-skills

MAmattpocock/skills288k10,178 new stars in the last 7 days

ask-matt

MAmattpocock/skills288k10,178 new stars in the last 7 days

agent-eval

AFaffaan-m/ECC278k4,046 new stars in the last 7 days

autonomous-agent-harness

AFaffaan-m/ECC278k4,046 new stars in the last 7 days