claude-md-architect — Claude Code skill: what it does, how to install
claude-md-architect is a Claude Code skill that builds and trims project CLAUDE.md files using codebase context, reducing token overhead by removing boilerplate.
no license 153 installs ★ 12 updated 2025-12-09
npx skills add samhvw8/dot-claude --skill claude-md-architect -a claude-codeWhat claude-md-architect does
This skill inspects your repository to prepare concise instructions for Claude Code. It reads package manifests, checks build scripts, and drafts project guidelines tailored to web apps, backend services, or monorepos. Generic programming principles get discarded so that the assistant receives only project-specific context.
When optimizing existing files, the skill strips duplicated documentation and condenses long sentences into bullet points. For complex setups nearing the 1000-token threshold, it separates secondary documentation into .claude/ARCHITECTURE.md and workflows into .claude/commands/.
Loading entire folders through @ imports quickly exhausts your context window, which is why the skill restricts imports to core configs and critical types.
What it helps with
- generate a fresh CLAUDE.md file tailored to your codebase
- strip redundant text and generic advice from existing guidelines
- reduce context token usage while keeping critical commands
- organize complex instructions across separate documentation files
Example prompts for the agent
- Inspect this repository and generate a concise CLAUDE.md
- Optimize our existing CLAUDE.md to cut down token usage
- Update project test and build instructions in CLAUDE.md
How to install claude-md-architect
1Skills CLI (Vercel)
npx skills add samhvw8/dot-claude --skill claude-md-architect -a claude-code2Manually: put the files in place
~/.claude/skills/claude-md-architect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/claude-md-architect/
1Skills CLI (Vercel)
npx skills add samhvw8/dot-claude --skill claude-md-architect -a codex2Manually: put the files in place
.agents/skills/claude-md-architect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add samhvw8/dot-claude --skill claude-md-architect -a cursor2Manually: put the files in place
.cursor/skills/claude-md-architect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install samhvw8/dot-claude skills/claude-md-architect2Manually: put the files in place
.github/skills/claude-md-architect/SKILL.md1Skills CLI (Vercel)
npx skills add samhvw8/dot-claude --skill claude-md-architect -a gemini-cli2Platform CLI
gemini skills install https://github.com/samhvw8/dot-claude --path skills/claude-md-architectManually: put the files in place
.devin/skills/claude-md-architect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add samhvw8/dot-claude --skill claude-md-architect -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about claude-md-architect
How to install claude-md-architect in Claude Code?
Run npx skills add samhvw8/dot-claude --skill claude-md-architect -a claude-code. The file will be placed in ~/.claude/skills/claude-md-architect/SKILL.md.
What does claude-md-architect do?
It generates and refines CLAUDE.md files by inspecting project conventions and build files. The skill cuts token waste by keeping only project-specific workflows and test commands.
How does it manage large instruction files?
For projects approaching 1000 tokens, it recommends keeping essential instructions in .claude/CLAUDE.md while moving architectural details into .claude/ARCHITECTURE.md.