index-knowledge

Generate hierarchical AGENTS.md knowledge bases with complexity-scored subdirectory documentation.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/kjanat/skills --skill index-knowledge-kjanat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: index-knowledge
Source: https://github.com/kjanat/skills/tree/main/skills/index-knowledge
Command: npx skills add https://github.com/kjanat/skills --skill index-knowledge-kjanat

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the creation and maintenance of comprehensive knowledge bases for codebases, making it easier to navigate and understand project structure and conventions.

Core Features & Use Cases

  • Hierarchical Documentation: Generates AGENTS.md files for the project root and relevant subdirectories.
  • Complexity Scoring: Identifies and documents complex or distinct modules based on file count, directory depth, and symbol density.
  • Use Case: For a large monorepo, this Skill can automatically create an AGENTS.md file for the main project and then generate separate, focused AGENTS.md files for key packages like src/api and src/utils, detailing their specific purpose and structure.

Quick Start

Use the index-knowledge skill to regenerate the AGENTS.md files for the current project, updating existing documentation.

Frequently Asked Questions about index-knowledge

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

FAQPage Schema
How do I generate hierarchical documentation for a large codebase?

To generate hierarchical documentation for a codebase, this Skill analyzes project structure, code complexity, and existing docs to create root and subdirectory AGENTS.md files. It uses complexity scoring based on file count and symbol density to identify distinct modules.

What is the best way to maintain an AGENTS.md knowledge base during agile development?

Maintaining an AGENTS.md knowledge base during agile development is handled through an update mode that regenerates files. The Skill updates documentation by concurrently exploring code changes and analyzing bash outputs to reflect current project conventions.

Can I use codebase analysis to document specific subdirectories like src/api and src/utils?

Yes, you can use codebase analysis to document specific subdirectories like src/api and src/utils. The Skill evaluates directory depth and file count to generate focused AGENTS.md files detailing the structure of complex packages.

Does generating an AGENTS.md knowledge base require LSP codemaps?

Generating an AGENTS.md knowledge base does not strictly require LSP codemaps, as they are optional. However, the Skill does require concurrent exploration agents and bash analysis to perform comprehensive codebase discovery and complexity scoring.

How does complexity scoring work when creating a code navigation knowledge base?

Complexity scoring for a code navigation knowledge base works by evaluating file count, directory depth, and symbol density. This identifies distinct modules to determine which subdirectories receive dedicated AGENTS.md files.