agent-init-deep
Initialize or migrate to nested CLAUDE.md structure for progressive disclosure. Claude auto-loads CLAUDE.md from any directory it enters, so nested files get discovered automatically. Use when setting up a new project's agent config, refactoring a bloated CLAUDE.md, or adding progressive disclosure to an existing repo. Triggers on: '/agent-init-deep', 'setup progressive disclosure', 'refactor claude.md', 'split claude.md', 'claude.md is too big'.
npx skills add majiayu000/claude-skill-registry --skill agent-init-deep --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Init Deep — Progressive Disclosure CLAUDE.md Set up or migrate to a progressive disclosure CLAUDE.md structure using `docs/agents/` for topic-specific guidance. ## Context Model ``` Static (root CLAUDE.md) — loaded every conversation, minimal, high-value Semi-dynamic (docs/agents/) — linked from root, loaded on-demand when relevant Fully dynamic (skills) — triggered by metadata match, loaded only when invoked ``` Root CLAUDE.md should be ~40-50 lines. Everything else belongs in docs/agents/ or skills. ## Target Structure ``` CLAUDE.md # Root: identity, tech stack, key rules, workflow, links docs/agents/ ├── tooling.md # e.g. package manager, linting, formatting, hooks ├── commands.md # e.g. script execution, build filters, passing args ├── guardrails.md # e.g. data isolation, secrets, library docs ├── definition-of-done.md # e.g. coverage, lint, type-check, format requirements └── [topic].md # Additional topic-specific files as needed ``` ## Workflow ### Step 1: Detect State ``` Check for: - CLAUDE.md exists? - docs/agents/ exists? - How many lines is CLAUDE.md? ``` If no CLAUDE.md → **Greenfield path** If CLAUDE.md exists → **Migration path** ### Step 2a: Greenfield Path Ask the
- Context Model
- Target Structure
- Workflow
- Step 1: Detect State
- Step 2a: Greenfield Path
- Step 2b: Migration Path
- Step 3: Post-Setup
- Root CLAUDE.md Template
- Classification Heuristic
- Principles
What does the agent-init-deep skill do?
Initialize or migrate to nested CLAUDE.md structure for progressive disclosure. Claude auto-loads CLAUDE.md from any directory it enters, so nested files get discovered automatically. Use when setting up a new project's agent config, refactoring a bloated CLAUDE.md, or adding progressive disclosure to an existing repo. Triggers on: '/agent-init-deep', 'setup progressive disclosure', 'refactor claude.md', 'split claude.md', 'claude.md is too big'.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agent-init-deep --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.