# reclaude

Splits a bloated CLAUDE.md into a short root file plus a .claude/rules/ folder. Useful once your agent instructions grow past the point where you can keep them in your head.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2800 installs · ★ 379
- Author: brianlovin
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/brianlovin/agent-config/tree/HEAD/skills/reclaude/SKILL.md
- Updated: 2026-03-25
- HTML: https://affpapa.org/en/nevibecode/skills/reclaude

## What it does

The skill walks through your `CLAUDE.md` step by step. First it counts lines and labels the result: under 50 is fine, 50–100 is tolerable, past 100 and content should move out. Then it keeps only what belongs at the root — a one-line project description, non-obvious commands, links to rule files.

Everything else gets sorted into `.claude/rules/` by topic, whether that is TypeScript conventions, testing patterns or Git workflow. It also hunts for instructions that contradict each other and asks which version you want to keep. There is a check for a `## Verification` section with commands the agent can run after edits; if it is missing, the skill looks in `package.json`, a `Makefile` or a `justfile` and builds the section from what it finds.

Finally it flags content worth deleting outright: API docs, code samples, type definitions, generic advice. If a chunk about a tool or framework shows up across two or more projects and runs longer than 20 lines, the skill suggests turning it into a global skill under `~/.claude/skills/`. The workflow orchestration step reads `~/.claude/skills/workflow/SKILL.md`, so without that file the step has nothing to pull from.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add brianlovin/agent-config --skill reclaude -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add brianlovin/agent-config --skill reclaude -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add brianlovin/agent-config --skill reclaude -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install brianlovin/agent-config reclaude
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add brianlovin/agent-config --skill reclaude -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/brianlovin/agent-config --path skills/reclaude
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add brianlovin/agent-config --skill reclaude -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/brianlovin/agent-config/tree/HEAD/skills/reclaude/SKILL.md

## When to use it
- trim a CLAUDE.md that has grown past a hundred lines
- sort agent instructions into topic files under `.claude/rules/`
- catch rules that contradict each other
- add a verification section with commands to run after edits
- lift repeated instructions into a global skill

## Example prompts
- refactor my CLAUDE.md to follow progressive disclosure
- check the length of CLAUDE.md and tell me what to move into .claude/rules/
- find contradictions in CLAUDE.md and ask me which one to keep

## Similar
- [health](https://affpapa.org/en/nevibecode/skills/health.md) — skill · 15800 installs
- [claude-md-improver](https://affpapa.org/en/nevibecode/skills/claude-md-improver.md) — skill · 12558 installs
- [code-reviewer](https://affpapa.org/en/nevibecode/agents/anthropic-code-reviewer.md) — subagent · 31050 installs
- [agents-md](https://affpapa.org/en/nevibecode/skills/agents-md.md) — skill · 7100 installs
- [improve-claude-md](https://affpapa.org/en/nevibecode/skills/improve-claude-md.md) — skill · 2500 installs
- [promote](https://affpapa.org/en/nevibecode/skills/promote.md) — skill · 1597 installs

From the same set: [brianlovin/agent-config](https://affpapa.org/en/nevibecode/by/brianlovin/agent-config.md) — 15 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