skill-authoring-workflow

SKILL.md

Transform rough notes and workshop content into validated, repo-compliant PM skills.

Guides you through six phases: preflight search, draft generation, tightening, strict validation, repo integration, and optional packaging

Enforces a strict definition of done including frontmatter validity, metadata limits (name ≤64 chars, description ≤200 chars), and section compliance

Provides three creation paths: guided wizard for ideas, content-first generator for existing source material, and manual edit plus validation for updates

Includes built-in scripts for duplicate detection, structural testing, metadata checking, and trigger validation before commit

Purpose

Create or update PM skills without chaos. This workflow turns rough notes, workshop content, or half-baked prompt dumps into compliant skills/<skill-name>/SKILL.md assets that actually pass validation and belong in this repo.

Use it when you want to ship a new skill without "looks good to me" roulette.

Key Concepts

Dogfood First

Use repo-native tools and standards before inventing a custom process:

scripts/find-a-skill.sh

scripts/add-a-skill.sh

scripts/build-a-skill.sh

scripts/test-a-skill.sh

scripts/check-skill-metadata.py

Pick the Right Creation Path