Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add samhvw8/dot-claude --skill claude-md-architect -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/claude-md-architect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/claude-md-architect/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set6

Project sponsors

Companies that keep this analytics open