init-deep

Generate hierarchical AGENTS.md documentation files for codebases.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/yzlin/supa-opencode --skill init-deep-yzlin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-deep
Source: https://github.com/yzlin/supa-opencode/tree/main/skills/init-deep
Command: npx skills add https://github.com/yzlin/supa-opencode --skill init-deep-yzlin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation and maintenance of essential project documentation files (AGENTS.md) that provide precise, context-aware information to AI agents, preventing information overload and ensuring efficient operation.

Core Features & Use Cases

  • Hierarchical Documentation: Generates AGENTS.md files at the root and relevant subdirectories based on complexity.
  • Contextual Awareness: Uses a combination of agent exploration, bash analysis, LSP codemaps, and existing file content to determine documentation needs.
  • Use Case: When starting a new project or onboarding an AI to an existing one, use this Skill to automatically create a structured knowledge base that guides the AI on where to find information and understand project specifics.

Quick Start

Run the init-deep skill to generate AGENTS.md files for the current project, updating existing ones.

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 context files for my codebase?

To generate AGENTS.md context files, you run the init-deep skill against your project. It uses concurrent exploration agents, bash analysis, and LSP codemaps to automatically create hierarchical documentation starting from the root directory down to complexity-scored subdirectories.

What is the best way to provide AI context for an existing codebase?

Providing AI context for an existing codebase is best achieved by generating structured AGENTS.md files. This approach uses a scoring matrix to identify and document critical areas, preventing information overload and ensuring the AI agent operates with precise, context-aware information.

How does complexity scoring work for project documentation initialization?

Complexity scoring for project documentation initialization evaluates subdirectories using concurrent exploration agents and LSP codemaps. This scoring matrix identifies critical areas within the codebase, ensuring that hierarchical AGENTS.md files are only generated where documentation is genuinely needed.

Can I update existing AGENTS.md files without a full regeneration?

You can update existing AGENTS.md files without a full regeneration. The initialization process supports both initial setup and targeted updates, offering options for full regeneration and depth control to maintain your hierarchical codebase documentation efficiently.

Do I need any external dependencies to run project context generation?

You do not need any external dependencies to run project context generation. The skill operates independently using built-in bash structural analysis, LSP codemaps, and concurrent exploration agents to analyze your codebase and produce the required AGENTS.md documentation.

When should I not use automated codebase analysis for AI context?

You should not use automated codebase analysis for AI context if your project lacks sufficient structural complexity or code volume. Because the documentation generation relies on a complexity scoring matrix, extremely flat or minimal projects may not benefit from the hierarchical AGENTS.md output.