skills.rest
Stephensmetana
StephensmetanaCOMMUNITY
Explore all skills by this author →
GitHub

skills-index

Scan repositories for SKILL.md files and generate structured catalogs.

Updated Apr 28, 2026
Search Tags:#documentation#indexing#report#skill.md#scan#skills-index
One-click install
npx skills add https://github.com/Stephensmetana/skill-scrolls --skill skills-index-stephensmetana
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skills-index
Source: https://github.com/Stephensmetana/skill-scrolls/tree/main/utilities/skills-index
Command: npx skills add https://github.com/Stephensmetana/skill-scrolls --skill skills-index-stephensmetana

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Index all SKILL.md skills across a repository to create a structured catalog.

Core Features & Use Cases

  • Recursive discovery: scans directories to locate every SKILL.md.
  • Grouping: aggregates skills by category for organized overviews.
  • Outputs: produces a JSON index, text report, or README for publishing as a repo.

Quick Start

Run the scan with python <path-to-skill>/scripts/scan_skills.py <target_directory> to generate a JSON index, a text report, or a README.

Frequently Asked Questions about skills-index

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

FAQPage Schema
How do I index all SKILL.md files in a repository into a structured catalog?▼

To index all SKILL.md files, run a recursive directory scan that detects frontmatter like name, description, and compatibility, then groups the discovered skills by category into a structured catalog report.

Can I generate a JSON index or README output from scanning SKILL.md files?▼

Yes, scanning SKILL.md files supports generating a JSON index, a text report, or a README output, allowing you to publish the structured catalog directly into your repository for documentation.

What is the best way to catalog skills across multiple directories by category?▼

The best way to catalog skills across directories is using a recursive scan that aggregates discovered SKILL.md files by category, detecting frontmatter and listing bundled resources for an organized overview.

How does the script detect SKILL.md frontmatter and bundled resources during a scan?▼

The script detects SKILL.md frontmatter by parsing metadata fields such as name, description, and compatibility, and it lists any bundled resources found within the skill directories during the recursive scan.

Do I need any dependencies to run a recursive scan for SKILL.md files?▼

No external dependencies are required to run the recursive scan for SKILL.md files; you can execute the indexing script directly using Python to generate your structured catalog without installing additional packages.

Related Skills

Explore More Software Engineering Skills→
lawve-ailawve-ai
630

eu-ai-act-report-oliver-schmidt-prietz

Scan repositories for SKILL.md frontmatter and generate standardized YAML metadata.

Official
Advanced
Svenja-devSvenja-dev
38

skill-doc-generator

Generate README.md files from SKILL.md metadata with validation.

Community
Intermediate
jayhjenkinsjayhjenkins
1

skill-discovery

Scan skill directories and extract SKILL.md frontmatter into categorized inventories.

Community
Basic
diegosanchespereira1diegosanchespereira1

bmad-index-docs

Generates or updates index.md with organized links and descriptions for visible files in a target directory.

Community
Basic