claude-optimised
by hexnickk
Coding Agents & IDEsBrief
Guide for writing and optimizing CLAUDE.md files.
Description
What This Skill Does
A guide for writing lean, effective CLAUDE.md files that Claude Code will actually follow. Covers what to include, what to cut, file placement, and how to maintain the file over time.
Most CLAUDE.md files are too long, causing Claude to skip critical rules — this guide enforces a pruning-first mindset that keeps instructions short enough to actually work.
When to Use It
- Creating a CLAUDE.md for a new project from scratch
- Auditing an existing CLAUDE.md that Claude seems to be ignoring
- Deciding which conventions are worth documenting vs. leaving implicit
- Setting up subdirectory-level CLAUDE.md files for monorepos
- Trimming a bloated CLAUDE.md after it grows past 50 lines
Example Workflow
User asks: review my CLAUDE.md and help me improve it
- 1
Reads the existing CLAUDE.md file
- 2
Checks each line against the 'would removing this cause mistakes?' test
- 3
Identifies redundant rules, obvious patterns, and prose that should be bullets
- 4
Suggests removals and rewrites remaining content as terse bullet points
- 5
Outputs a revised CLAUDE.md under 50 lines
A trimmed CLAUDE.md containing only non-obvious conventions, critical warnings, and project-specific commands
Installation
clawhub install hexnickk/claude-optimisedRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.