init-deep — Hierarchical AGENTS.md Knowledge Base Generator
Explores and scores your repo in parallel, then generates hierarchical AGENTS.md docs at the root and in high-complexity subdirectories.
Dev & CodingAdvanced★ 67,531⑂ 5,507AI score 9/10Last updated: Aug 9, 2026
What it does
- Fires multiple background explore agents at once to gather project structure, entry points, conventions, anti-patterns, build/CI, and test patterns.
- Meanwhile the main session runs bash (find/wc) for depth and file density, and drives LSP (
lsp_symbols,lsp_find_references) plus ast-grep to build a CODE MAP with reference centrality. - Applies a weighted scoring matrix (file count, subdir count, symbol density, exports, reference centrality) to decide where AGENTS.md belongs: >15 create, 8–15 create if a distinct domain, <8 skip.
- Writes a full template at the root (OVERVIEW / STRUCTURE / WHERE TO LOOK / CODE MAP / CONVENTIONS / ANTI-PATTERNS / COMMANDS) and 30–80 line child docs, then reviews everything to strip generic advice and parent duplication.
- Saves a
.omo/init-deep.jsonsnapshot and asks whether the output should staylocalor go incommittedthrough a PR workflow.
Who it's for
- Developers documenting large codebases or monorepos so AI agents have reliable context.
- Teams tired of hand-writing CLAUDE.md/AGENTS.md who want generation plus deduplication.
- Advanced users with LSP/ast-grep available and the ability to run parallel subagents.
Examples
/init-deep— update existing AGENTS.md files and add new ones where scores warrant it./init-deep --create-new— read all existing docs for context, delete them, and regenerate from scratch./init-deep --max-depth=2— restrict analysis depth so the docs tree stays small.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/HEAD/packages/omo-senpi/skills/init-deep/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the packages/omo-senpi/skills/init-deep folder from the GitHub repo code-yeongyu/oh-my-openagent into my ~/.claude/skills/code-yeongyu-init-deep/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/code-yeongyu/oh-my-openagent.git && mkdir -p ~/.claude/skills && cp -r oh-my-openagent/packages/omo-senpi/skills/init-deep ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - Create the skills folder if needed:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r oh-my-openagent/packages/omo-senpi/skills/init-deep ~/.claude/skills/ - Verify that
~/.claude/skills/init-deep/SKILL.mdexists. - Recommended: install
ast-grep(sg) andnode, and confirm LSP tools are enabled in your agent setup. - Restart Claude Code, cd into your project root, and run
/init-deep. - When prompted "Local or committed?", answer
localto keep docs untracked orcommittedto route them through a reviewed PR.
View source on GitHub ↗License: NOASSERTION