skill-garden-catalogue

Extract skill metadata from SKILL.md files into Markdown and HTML catalogues.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill skill-garden-catalogue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-garden-catalogue
Source: https://github.com/agilebydesign/agilebydesign-skills/tree/main/skills/skill-garden-catalogue
Command: npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill skill-garden-catalogue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires frontmatter_tags, and includes scripts (resource) components.

What problem does it solve?

Teams often struggle to find and understand what skills are deployed across a growing toolkit. This Skill provides a searchable, human-friendly catalogue that surfaces each skill's purpose and outputs a concise summary for quick decision-making.

Core Features & Use Cases

  • Regenerates a Markdown inventory and an HTML catalogue of all deployed skills for easy sharing.
  • Derives lightweight summaries (challenge and solution) from each SKILL.md to support rapid exploration.
  • Outputs skill-inventory.md and catalog/index.html in a deterministic workflow to keep documentation current.
  • Use Case: refresh the catalogue after adding or updating a skill so teams can discover capabilities at a glance.

Quick Start

Run python scripts/generate_catalogue.py --skills-dir <path> to regenerate the catalogue.

Frequently Asked Questions about skill-garden-catalogue

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

FAQPage Schema
How do I generate a markdown inventory of all deployed skills?

To generate a markdown inventory of deployed skills, run the catalogue script against your skills directory. It indexes each SKILL.md to extract metadata and outputs a deterministic skill-inventory.md file for quick discovery and documentation sharing.

What is the best way to create a browsable HTML catalogue from SKILL.md files?

Creating a browsable HTML catalogue from SKILL.md files is done by running the generation script, which parses frontmatter and body content to derive summaries, producing a stable catalog/index.html output for easy team sharing.

Does the skill catalogue generator require frontmatter tags in SKILL.md files?

Yes, the skill catalogue generator requires frontmatter tags as a dependency. It relies on the SKILL.md frontmatter to derive metadata like name, challenge, and solution, ensuring the generated markdown and HTML outputs remain accurate and current.

Can I automatically refresh documentation after adding a new skill to the library?

You can automatically refresh documentation after adding a new skill by running the catalogue generation script. It regenerates both the markdown inventory and HTML catalogue in a deterministic workflow, ensuring teams can discover newly added capabilities at a glance.

What limitations exist when indexing deployed skills with SKILL.md files?

A key limitation when indexing deployed skills is that the catalogue relies entirely on the presence and structure of SKILL.md frontmatter. If frontmatter tags are missing or malformed, the script cannot accurately derive the metadata needed for the markdown and HTML outputs.