What should I never include in my CLAUDE.md?

Avoid including sensitive secrets like API keys, temporary notes, redundant change logs, or overly verbose implementation details that waste token memory.

What is the purpose of a CLAUDE.md file?

CLAUDE.md is a markdown file placed in the project root that Claude Code automatically reads to understand the project's purpose, tech stack, commands, and rules.

How long should my CLAUDE.md file be?

The recommended size is under 300 lines. For larger projects, specific implementation patterns and rules should be moved to a dedicated /rules directory to maintain efficiency.

Can I use multiple CLAUDE.md files in one project?

Yes, you can place CLAUDE.md files in subdirectories like /src or /tests to define localized rules that only apply to those specific scopes.

Claude MD Guide

Name: Claude MD Guide
Author: biwakonbu

bybiwakonbu

0•

学習とドキュメンテーション

Provides expert guidance and best practices for structuring CLAUDE.md files to optimize project context for Claude Code.

The Claude MD Guide skill helps developers craft the perfect CLAUDE.md file to serve as a high-efficiency memory and instruction set for Claude Code. It provides standardized templates for project overviews, technical stacks, development commands, and coding conventions, ensuring the AI assistant has immediate access to essential project metadata. By offering specific advice on file size limits and modularization strategies, such as when to migrate rules to subdirectories, this skill prevents token bloat and improves the accuracy of Claude's responses within any development environment.

主な機能

01Explains hierarchical CLAUDE.md configuration for nested subdirectories

02Provides standardized CLAUDE.md templates for different project scales

03Offers size optimization recommendations to prevent memory overload

04Guides on modularizing detailed rules into a dedicated rules/ directory

05Outlines essential project metadata requirements like tech stacks and commands

060 GitHub stars

ユースケース

01Standardizing documentation and coding conventions for AI-assisted team workflows

02Refactoring a large, messy project configuration into a clean CLAUDE.md structure

03Setting up a new project for optimal interaction with Claude Code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add biwakonbu/cc-plugins claude-md-guide

For use in Claude.ai and ChatGPT

Download Skill