skills.rest
UtsavBalar1231
UtsavBalar1231COMMUNITY
Explore all skills by this author →
Website𝕏@UtsavTheCuntGitHub

init-deep

Generates hierarchical AGENTS.md documentation files for a codebase using parallel exploration and complexity scoring.

1|Updated Feb 23, 2026
Search Tags:#code analysis#documentation generation#project onboarding#agents.md#codebase documentation#repository structure#explore agents
One-click install
npx skills add https://github.com/UtsavBalar1231/oh-my-claudeagent --skill init-deep-utsavbalar1231
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init-deep
Source: https://github.com/UtsavBalar1231/oh-my-claudeagent/tree/main/skills/init-deep
Command: npx skills add https://github.com/UtsavBalar1231/oh-my-claudeagent --skill init-deep-utsavbalar1231

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New or unfamiliar codebases lack structured documentation, forcing developers to manually explore directory layouts, conventions, and entry points before they can work effectively. This Skill automates the creation of hierarchical AGENTS.md knowledge base files so AI agents and developers get accurate project context immediately. ## Core Features & Use Cases - Parallel Discovery: Launches concurrent explore agents to analyze project structure, entry points, conventions, anti-patterns, build systems, and test patterns simultaneously. - Complexity Scoring: Scores each directory on file count, code ratio, module boundaries, and symbol density to decide which subdirectories warrant their own AGENTS.md file. - Hierarchical Generation: Creates a root AGENTS.md plus focused subdirectory files, then deduplicates and trims content to enforce quality gates. - Use Case: After cloning a large monorepo, run the skill to produce a root knowledge base plus per-module AGENTS.md files so every future agent session starts with accurate, non-redundant project context. ## Quick Start Ask the agent to run /init-deep on your project to generate hierarchical AGENTS.md documentation for the codebase.

Frequently Asked Questions about init-deep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate AGENTS.md files for my codebase?▼

Run /init-deep in the project root to analyze the codebase and generate a root AGENTS.md plus subdirectory files where complexity warrants them. Use /init-deep --create-new to regenerate everything from scratch after reading existing files.

How does init-deep decide which directories get an AGENTS.md?▼

It scores each directory on file count, subdirectory count, code ratio, module boundaries, symbol density, and reference centrality. Directories scoring above 15 always get a file, scores of 8-15 get one only for distinct domains, and lower scores are covered by the parent.

Can I limit how deep the AGENTS.md generation goes?▼

Yes, pass --max-depth=N to restrict directory traversal depth, with a default of 3 levels. This keeps documentation focused on the most relevant top-level modules in deep repositories.

Does init-deep overwrite existing AGENTS.md files?▼

By default it runs in update mode, modifying existing files and creating new ones where warranted. The --create-new flag reads existing files first to preserve context, then removes and regenerates them from scratch.

What are the limitations of generated AGENTS.md documentation?▼

Generated files are capped at 50-150 lines for the root and 30-80 lines for subdirectories, so they capture deviations and non-obvious structure rather than exhaustive detail. Generic advice applicable to all projects is deliberately removed during review.

Related Skills

Explore More Software Engineering Skills→
stark-ai-destark-ai-de
4

codegraph-ast-grep

Integrate CodeGraph and ast-grep for semantic repository maps and structural search.

Official
Advanced
jal-cojal-co
7

agent-navigation-sop

Generate AGENTS.md files documenting AI agent navigation for codebases.

Community
Advanced
sustinbebustinsustinbebustin

index-knowledge

Generate hierarchical CLAUDE.md knowledge base files with complexity-scored subdirectory documentation.

Community
Advanced
arthun01arthun01

stimulus-patterns

Generate modular Stimulus controllers for progressive HTML enhancement.

Community
Intermediate