I built a Claude Code skill that generates better CLAUDE.md by best practices + scanning your repo + asking you 6 questions
Been annoyed at how inconsistent CLAUDE.md files are — some are bloated essays,
some are basically empty. So I made a skill that does it properly.
Here's what it does:
Scans your repo autonomously — reads manifests, detects your stack, checks
linter configs, looks at git history for commit conventions
Asks you exactly 6 questions — the stuff only you can answer (gotchas,
what's out of scope, approval gates, external Confluence/Notion links)
Generates a file under 80 lines where every line prevents a real mistake
The 80-line cap is a hard constraint, not a suggestion. Bloated CLAUDE.md files
cause the harness to down-weight ALL instructions uniformly — including the
important ones. So the skill will split overflow into agent_docs/ auxiliary files
rather than let the root file balloon.
It also refuses to add things like:
- Style rules your linter already enforces
- "Be a senior engineer" personality prompts (zero effect)
- Pasted Confluence content (CLAUDE.md is not a cache)
Works with Claude Code and Codex CLI.
GitHub: https://github.com/sruthik27/creating-claude-md
Would love feedback — especially if you've tried it on a monorepo or a repo
with Confluence docs linked.