Claude Code Development Style Guide (Skill)

This is a Claude Code skill that teaches Claude how to work with the Claude Code codebase following its established patterns and conventions.

Installation

To use this skill in your Claude Code sessions:

# From the repo root
claude skill add ./claude-code-skills

Or reference it directly in your CLAUDE.md:

/skill:claude-code-dev

What's Included

Guide	Description
Project Overview	Tech stack, build system, dependencies
Directory Structure	File organization and where things go
Import Conventions	ESM imports, type imports, feature flags
Naming Conventions	Casing rules for files, variables, types
TypeScript Patterns	Branded types, unions, Zod schemas
Commenting Style	JSDoc, why-not-what philosophy
Error Handling	Custom errors, graceful degradation
Function Patterns	Factories, memoize, async generators
Tool Architecture	How to add new tools
Command Architecture	How to add new commands
State Management	Module state, AppState threading
Testing Conventions	Test patterns and helpers
Formatting Rules	Code style (no semicolons, single quotes)
Quick References	Step-by-step checklists

Usage

Once installed, Claude will automatically use this skill when you work on the Claude Code source code. It ensures all contributions match the existing codebase style.