describe-roadmap

Display metadata, goal, and all steps of the active roadmap.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mikefullerton/cat-herding --skill describe-roadmap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: describe-roadmap
Source: https://github.com/mikefullerton/cat-herding/tree/main/skills/describe-roadmap
Command: npx skills add https://github.com/mikefullerton/cat-herding --skill describe-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a focused, readable view of an active roadmap, including its goal, overall progress, and each step with full details to aid review and planning.

Core Features & Use Cases

  • Show full roadmap metadata (name, goal, creation date, status) and the current progress across all steps.
  • List each step with detailed information such as status, dependencies, type, complexity, and notes.
  • Use when you need to audit roadmap health, compare multiple roadmaps, or prepare for the next planning gate.

Quick Start

Run the describe-roadmap command to view detailed information about the active roadmap.

Frequently Asked Questions about describe-roadmap

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

FAQPage Schema
How do I inspect a roadmap to see its goals, progress, and step details?

To inspect a roadmap, run the describe-roadmap command. It reads frontmatter and Roadmap.md content to display metadata, goals, overall progress, and each step with status, dependencies, complexity, and notes.

Can I compare multiple roadmaps to audit their health and step statuses?

Yes, you can compare multiple roadmaps by running describe-roadmap on each one. It renders a comprehensive view of metadata, goals, progress, and step dependencies, supporting in-depth roadmap health audits.

What roadmap metadata is displayed when reviewing a roadmap?

Reviewing a roadmap displays its full metadata, including name, goal, creation date, and status. It also calculates current progress across all steps and lists detailed notes, dependencies, type, and complexity for each step.

How do I check step dependencies and notes before the next planning gate?

To check step dependencies and notes before a planning gate, run the describe-roadmap command. It reads the active roadmap content to list every step with its detailed status, dependencies, type, complexity, and notes.

What is the best way to get a readable overview of an active roadmap?

The best way to get a readable overview of an active roadmap is the describe-roadmap command. It uses a shared library and script to parse frontmatter and content, rendering a user-friendly summary of goals, progress, and steps.

Do I need any dependencies to view detailed roadmap information?

No dependencies are required to view detailed roadmap information. The Skill uses an internal shared library and script to read frontmatter and Roadmap.md content directly, providing a comprehensive view without external components.