# claude-md-architect

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 153 installs · ★ 12 repo stars
- Author: samhvw8
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/samhvw8/dot-claude/tree/HEAD/skills/claude-md-architect/SKILL.md
- Updated: 2025-12-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/claude-md-architect

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add samhvw8/dot-claude --skill claude-md-architect -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/claude-md-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/claude-md-architect/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add samhvw8/dot-claude --skill claude-md-architect -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/claude-md-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add samhvw8/dot-claude --skill claude-md-architect -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/claude-md-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install samhvw8/dot-claude skills/claude-md-architect
```

2. **Manually: put the files in place**
- File: `.github/skills/claude-md-architect/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add samhvw8/dot-claude --skill claude-md-architect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/samhvw8/dot-claude --path skills/claude-md-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/claude-md-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add samhvw8/dot-claude --skill claude-md-architect -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/samhvw8/dot-claude/tree/HEAD/skills/claude-md-architect/SKILL.md

## When to use it
- 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
- 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

## Similar
- [remember](https://affpapa.org/en/nevibecode/skills/yeachan-heo-remember.md) — skill · 695 installs
- [context-driven-development](https://affpapa.org/en/nevibecode/skills/context-driven-development.md) — skill · 11099 installs
- [keep-the-why](https://affpapa.org/en/nevibecode/skills/keep-the-why.md) — skill · ★ 240 repo stars
- [agents-md](https://affpapa.org/en/nevibecode/skills/agents-md.md) — skill · 7800 installs
- [prime_tts](https://affpapa.org/en/nevibecode/commands/prime-tts.md) — command · ★ 3990 repo stars
- [archcore](https://affpapa.org/en/nevibecode/hooks/archcore.md) — hook · ★ 1596 repo stars

From the same set: [samhvw8/dot-claude](https://affpapa.org/en/nevibecode/by/samhvw8/dot-claude.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
