description-linter

What problem does it solve?

Analyzes YAML frontmatter and trigger phrases across skills/*/SKILL.md to ensure trigger quality, consistent naming, and absence of cross-skill conflicts.

Core Features & Use Cases

• Validate presence of actionable trigger phrases and verbs in SKILL.md frontmatter.
• Enforce frontmatter rules (name, description) and constraints like length caps and kebab-case naming.
• Detect cross-skill conflicts by comparing trigger phrases across skills, and surface actionable reports.
• Produce human-readable reports without performing automated edits for safe review.
• Use case: perform skill audits before releases or during updates to guard against ambiguity and naming drift.

Quick Start

Invoke the linter against all skills to report description issues without making changes.