Guide for writing and optimizing CLAUDE.md files for maximum Claude Code performance. Use when creating new CLAUDE.md, reviewing existing ones, or when user asks about CLAUDE.md best practices. Covers structure, content, pruning, and common mistakes.
Security Analysis
high confidenceAn instruction-only guide for writing CLAUDE.md files; its requirements and instructions are consistent with the stated purpose and it does not request credentials, install software, or perform other surprising actions.
Name and description match the SKILL.md content: the file is a focused authoring/optimization guide for CLAUDE.md. There are no declared env vars, binaries, or install steps that would be unrelated to this purpose.
Runtime instructions are editorial guidance for composing CLAUDE.md files (structure, content, placement). They do not instruct the agent to read or transmit unrelated system files, access credentials, or call external endpoints. The guide mentions recommended file locations (e.g., ~/.claude/CLAUDE.md) but does not itself perform I/O.
No install spec and no code files. This is low-risk: nothing is downloaded or written by the skill itself.
No environment variables, credentials, or config paths are required by the skill. The content advises where users may place CLAUDE.md files, but the skill does not request access to those paths.
Skill is user-invocable and not flagged always:true. It does not request persistent platform presence or modify other skills' settings. Note: the guide recommends persistent CLAUDE.md locations (e.g., ~/.claude/); that is a user decision and not an automatic action by the skill.
Guidance
This is an instruction-only, read-only guide and appears coherent with its stated goal. Before using it: 1) remember that following its advice to place a global CLAUDE.md in ~/.claude makes that content persistent across sessions — do not put secrets, API keys, or private credentials in those files; 2) the skill itself does not install software or ask for credentials, but always review any CLAUDE.md you create or accept from others for sensitive data; 3) if future versions add install steps, environment requirements, or code files, re-review for unrelated or excessive access (e.g., cloud credentials, network endpoints, or downloads from unknown URLs).
Latest Release
v1.0.1
- Major rewrite: skill focus changed from enforcing response optimization to guiding CLAUDE.md file writing. - Now provides concise best practices and anti-patterns for CLAUDE.md optimization. - Includes specific structural, formatting, and pruning advice. - Removes previous XML/output rules and step-by-step workflow details. - Adds checklists, practical examples, and clarifies what not to include.
Popular Skills
Published by @hexnickk on ClawHub