Should I include my code style guide in CLAUDE.md?

No. Style guidelines are best handled by deterministic tools like linters and formatters. Including them in CLAUDE.md wastes token space and can lead to inconsistent results.

How do I reference specific code without making the file too long?

Use 'file:line' pointers (e.g., src/auth.ts:15) instead of copy-pasting code blocks. This keeps the context file current and allows Claude to read the actual file only when necessary.

Why is a smaller CLAUDE.md file better for Claude Code?

Large files compete for attention and waste the instruction budget. Keeping it under 60-300 lines ensures Claude remains focused on your specific tasks without being distracted by irrelevant context.

What are the three essential sections every project file needs?

A high-quality CLAUDE.md should focus on WHAT (tech stack and structure), WHY (purpose and business context), and HOW (essential build, test, and run commands).

Better CLAUDE.md Initialization

Name: Better CLAUDE.md Initialization
Author: sdui-hq

bysdui-hq

0•

生産性とワークフロー

Guides the creation and optimization of CLAUDE.md files to provide high-leverage project context for Claude Code.

This skill provides a standardized framework for initializing and maintaining CLAUDE.md, the primary context file used by Claude Code to understand a repository. By focusing on essential WHAT, WHY, and HOW sections while utilizing progressive disclosure and file-specific pointers, it ensures Claude has the highest quality project context without exhausting the token budget. It prevents common anti-patterns like 'kitchen sink' documentation or redundant style guides, leading to more accurate and efficient AI-assisted development across any codebase.

主な機能

01Implements progressive disclosure to keep main context lean

020 GitHub stars

03Uses file:line pointers instead of embedding bloat-heavy code snippets

04Enforces conciseness with a target of under 60 lines for performance

05Filters out redundant style guides to prioritize actionable project rules

06Standardized WHAT/WHY/HOW structure for optimal project context

ユースケース

01Standardizing documentation across monorepos and team projects

02Initializing project context for new Claude Code users

03Refactoring bloated CLAUDE.md files that degrade AI performance

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sdui-hq/ai-marketplace init-guidance

For use in Claude.ai and ChatGPT

Download Skill