gaia-index-docs

Indexes Markdown, XML, YAML, and CSV files in a folder into a linked table of contents in index.md.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-index-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-index-docs
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-index-docs
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-index-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates a complete, navigable index for all documents in a target folder, saving time locating files and ensuring consistency across projects.

Core Features & Use Cases

  • Automated indexing: scans Markdown, XML, YAML, and CSV files and produces a structured index.md with a linked table of contents.
  • Preserves manual edits: merges with existing index.md by preserving non-auto-generated sections.
  • Flexible deployment: updates an index across project folders, enabling quick file discovery and documentation audits.

Quick Start

Invoke the skill with the target folder path to generate an index at the target folder's index.md.

Frequently Asked Questions about gaia-index-docs

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

FAQPage Schema
How do I generate a table of contents for a folder of markdown and yaml files?

To generate a table of contents for a folder, this skill scans your directory for markdown, yaml, xml, and csv files, then automatically writes a structured index.md with relative links to each document.

Can I update an existing folder index without losing my manual notes?

Yes, you can update an existing folder index without losing manual notes. The skill merges new scan results while preserving non-auto-generated sections in your current index.md file.

What is the best way to index documentation across multiple project folders?

The best way to index documentation across project folders is to run this skill against each target directory, producing a navigable index.md that ensures quick file discovery and consistency.

Does automated folder indexing work with csv and xml files?

Automated folder indexing works with csv and xml files. It scans these formats alongside markdown and yaml, producing a unified table of contents for your entire documentation library.

When do I need to create a searchable index for my documents?

You need to create a searchable index for your documents when locating files manually becomes time-consuming, or when you are performing a documentation audit across a large project folder.