index-knowledge

Generate hierarchical AGENTS.md files with scoring-based location guidance.

Updated Dec 21, 2024
One-click install
npx skills add https://github.com/ryanmiville/dotfiles --skill index-knowledge-ryanmiville
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: index-knowledge
Source: https://github.com/ryanmiville/dotfiles/tree/main/home/.agents/skills/index-knowledge
Command: npx skills add https://github.com/ryanmiville/dotfiles --skill index-knowledge-ryanmiville

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of a hierarchical AGENTS.md knowledge base for a codebase, enabling structured discovery and onboarding.

Core Features & Use Cases

  • Root + subdirectory AGENTS.md generation: Produce a central index plus depth-limited subdirectory documentation with scoring.
  • Parallel generation workflow: Spawn and merge multiple AGENTS.md files concurrently to speed up project-wide documentation.
  • Onboarding & maintenance: Simplify new contributor onboarding by surfacing conventions, patterns, and hotspots.

Quick Start

Run the index-knowledge skill to generate AGENTS.md for your repository and its critical submodules.

Frequently Asked Questions about index-knowledge

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

FAQPage Schema
How do I generate an AGENTS.md knowledge base for my codebase?▼

You need an AGENTS.md knowledge base to provide structured discovery and onboarding for a codebase, mapping conventions, patterns, and hotspots so new contributors can quickly understand project architecture.

How does parallel generation work for AGENTS.md files?▼

Parallel generation for AGENTS.md files works by spawning and merging multiple documentation files concurrently across subdirectories, speeding up project-wide documentation sprints and architecture reviews.

Can I limit the depth of subdirectory AGENTS.md generation?▼

Yes, you can limit the depth of subdirectory AGENTS.md generation because the skill produces depth-limited subdirectory documentation with scoring-based location guidance for critical submodules.

When should I use automated AGENTS.md generation over manual documentation?▼

Automated AGENTS.md generation is best used during project onboarding, architecture reviews, and documentation sprints when you need to rapidly map structure and complexity across a large codebase.

What is the AGENTS.md format used for in codebase onboarding?▼

The AGENTS.md format is used in codebase onboarding to serve as a hierarchical knowledge base, providing a central index plus subdirectory documentation that surfaces conventions and patterns.