Skill Analyzer

Reference patterns for extracting structured metadata from SKILL.md files.

Note: Actual analysis is performed by demo-producer/scripts/generate.sh . This skill provides reference patterns.

Output Structure

interface SkillMetadata { name: string; description: string; tags: string[]; version: string; userInvocable: boolean; context: 'fork' | 'inherit' | 'none';

// Extracted content phases: WorkflowPhase[]; examples: CodeExample[]; keyFeatures: string[]; relatedSkills: string[]; }

interface WorkflowPhase { name: string; description: string; tools: string[]; isParallel: boolean; }

interface CodeExample { language: string; code: string; description: string; }

Extraction Rules

Frontmatter Parsing (Bash)

Extract name

name=$(grep "^name:" SKILL.md | head -1 | cut -d: -f2- | xargs)

Extract description

description=$(grep "^description:" SKILL.md | head -1 | cut -d: -f2- | xargs)

Extract tags

tags=$(grep "^tags:" SKILL.md | sed 's/tags: [//' | sed 's/]//' | tr -d '"')

Phase Detection

• Look for ## Phase N: or ### Phase N: headers

• Extract tools from code blocks (Grep, Glob, Read, Task, etc.)

• Detect parallel execution from "PARALLEL" comments or multiple tool calls

Example Detection

• Find code blocks with language tags

• Extract surrounding context as description

• Identify quick start examples

Feature Detection

• Parse bullet points after "Key Features" or "What it does"

• Extract from description field

• Identify from tags

Usage in Demo Pipeline

Integrated into demo-producer

./skills/demo-producer/scripts/generate.sh skill explore

Internally calls extraction functions to:

1. Parse SKILL.md frontmatter

2. Extract phases from ## headers

3. Identify related skills

4. Generate demo script with extracted content

Related Skills

• demo-producer : Uses skill-analyzer output for script generation

• terminal-demo-generator : Creates recordings based on extracted phases

• content-type-recipes : Templates that consume analyzed metadata

References

See references/ for detailed extraction patterns:

• frontmatter-parsing.md

• YAML frontmatter extraction

• phase-extraction.md

• Workflow phase detection