layered-summary

Generate hierarchical AGENTS.md summaries for codebase directories.

52|4|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/vicnaum/vics-agent-skills --skill layered-summary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: layered-summary
Source: https://github.com/vicnaum/vics-agent-skills/tree/main/skills/layered-summary
Command: npx skills add https://github.com/vicnaum/vics-agent-skills --skill layered-summary

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Navigating large codebases is challenging. This Skill helps AI agents understand complex repositories by creating hierarchical summaries, making it easier to locate relevant code and grasp architectural overviews.

Core Features & Use Cases

  • Hierarchical Summaries: Generates AGENTS.md files that summarize directories from the deepest levels upwards, creating a layered view of the codebase.
  • Incremental Updates: Can update existing summaries after code changes, ensuring documentation stays current.
  • Use Case: When working on a large project like reth/crates/engine, this Skill can generate a layered summary, allowing an AI agent to quickly understand the purpose of each subdirectory and its key components without reading every file.

Quick Start

Use the layered-summary skill to create a layered summary of the reth/crates/engine directory.

Frequently Asked Questions about layered-summary

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

FAQPage Schema
How do I generate a repository overview to help AI agents navigate a large codebase?

Generate a repository overview by creating hierarchical `AGENTS.md` files per directory. These layered summaries detail files, key APIs, and relationships, rolling up from the deepest directories to provide a comprehensive architectural overview for AI agents.

What is the best way to create codebase summaries that capture the architecture layer by layer?

Creating codebase summaries layer by layer involves a subagent-first workflow that explores directories from the bottom up. This generates `AGENTS.md` files summarizing each subtree's files and APIs, rolling up into a complete architectural overview without reading every file.

Can I update existing codebase documentation automatically after code changes?

Yes, you can update existing codebase documentation automatically after code changes. The incremental update feature refreshes the `AGENTS.md` summaries, ensuring the hierarchical repository documentation stays current with the latest code modifications.

How does hierarchical summary generation work for understanding complex repository structures?

Hierarchical summary generation works by creating `AGENTS.md` files that summarize directories from the deepest levels upwards. This subagent-first workflow explores the codebase comprehensively, rolling up file details and key APIs into an architectural overview.

Does generating layered summaries require any external dependencies or environment setup?

Generating layered summaries requires no external dependencies. The Skill operates independently using its built-in scripts and references to create `AGENTS.md` files and perform subagent-first codebase exploration.

When should I avoid using automated layered summaries for codebase analysis?

You should avoid automated layered summaries when working with very small repositories where reading files directly is faster, or when your codebase lacks a clear directory structure, as the hierarchical roll-up relies on subtree organization to build an accurate architectural overview.