skill-discovery

Scan project and user directories for SKILL.md files and generate a structured skill catalog.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill skill-discovery-krzemienski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-discovery
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/skill-discovery
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill skill-discovery-krzemienski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Glob, Read.

What problem does it solve?

Skill discovery automatically inventories SKILL.md files across project, user, and plugin scopes to build a comprehensive skill catalog for intelligent selection and invocation.

Core Features & Use Cases

  • Automated scanning of skills directories
  • YAML frontmatter parsing for metadata
  • Catalog construction with namespace and triggers
  • Cache results in Serena MCP for session persistence

Quick Start

Run discovery to generate a catalog of all available skills in the environment.

Frequently Asked Questions about skill-discovery

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

FAQPage Schema
How do I automatically catalog all skills in my project?

Skill discovery automatically scans your project and user directories for SKILL.md files, extracts YAML frontmatter metadata (name, description, skill-type, requirements), and builds a structured catalog with namespace, file path, and line count. Run `/shannon:discover_skills` on demand or let it run at session start.

What metadata does skill discovery extract from SKILL.md files?

Discovery parses YAML frontmatter to extract skill name, description, skill-type, MCP requirements, and required sub-skills. It also counts file lines and assigns a namespace. Results cache in Serena MCP for session persistence.

When does skill discovery run automatically?

Discovery runs at session start, before command execution, when you call `/shannon:discover_skills`, and whenever the skill catalog updates. This ensures your metadata inventory stays current throughout your session.

Can I use skill discovery to find skills across multiple directories?

Yes. Discovery scans project scope, user scope, and plugin directories in a single pass, aggregating all SKILL.md files into one comprehensive catalog with consistent namespace and metadata structure.

Do I need special setup to cache discovery results?

Discovery caches results in Serena MCP when available, enabling persistent catalog access across sessions without rescanning. If Serena is not available, discovery still builds and outputs the catalog but without session-level caching.