deepinit

Generate and update hierarchical AGENTS.md files with parent references and preservation markers.

40|9|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/akillness/jeo-skills --skill deepinit-akillness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deepinit
Source: https://github.com/akillness/jeo-skills/tree/main/.agent-skills/deepinit
Command: npx skills add https://github.com/akillness/jeo-skills --skill deepinit-akillness

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Creates comprehensive, hierarchical AGENTS.md documentation across the entire codebase, guiding AI agents with directory purpose, relationships, and special instructions while excluding runtime state.

Core Features & Use Cases

  • Generates and maintains AGENTS.md files in a navigable hierarchy with correct parent references for non-root directories.
  • Enforces the MANUAL preservation marker and preserves manual notes across regenerations.
  • Provides references and guidelines (scope-and-preservation) to ensure runtime state is not documented and supports validation workflows.

Quick Start

Run the deepinit workflow on the target directory to generate its AGENTS.md hierarchy.

Frequently Asked Questions about deepinit

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

FAQPage Schema
How do I automate hierarchical AGENTS.md documentation across my codebase?

You can automate hierarchical AGENTS.md documentation by running a script-based workflow that identifies, organizes, and generates parent-referenced files across your repository folders while excluding runtime state.

What is the best way to maintain parent references in non-root AGENTS.md files?

Maintaining parent references in non-root AGENTS.md files is handled automatically by the generation workflow, which enforces the correct hierarchy and validates that each file includes a valid parent reference.

How does manual preservation work when regenerating AGENTS.md files?

Manual preservation works by enforcing a specific marker in each AGENTS.md file, allowing the regeneration workflow to validate and preserve your manual notes across updates without overwriting them.

Can I exclude runtime state from my directory documentation for AI agents?

Yes, you can exclude runtime state from directory documentation by applying scope-and-preservation references that enforce the convention of omitting runtime data during the generation and validation workflow.

Does deepinit require any external dependencies to validate AGENTS.md hierarchies?

No, deepinit requires zero external dependencies to validate AGENTS.md hierarchies, relying entirely on its internal scripts and references to execute the generation, updating, and validation workflows.

Why does my AGENTS.md hierarchy validation fail after manual edits?

AGENTS.md hierarchy validation fails after manual edits if the files lack a valid parent reference or the manual-preservation marker, which the validation script checks for to ensure structural consistency.