Skill Authoring Workflow

If you're maintaining a skills repo with any kind of standards, you know the pain: someone dumps a wall of text, calls it a skill, and breaks validation. This workflow gives you the six-phase discipline to go from rough notes to a compliant SKILL.md that actually passes metadata checks and fits the catalog. It leans hard on dogfooding the repo's own scripts (find-a-skill.sh, add-a-skill.sh, test-a-skill.sh) and enforces a definition of done with no exceptions. The facilitation protocol borrows from workshop-facilitation for guided sessions, and it's opinionated about when to use the wizard versus content-first generation. Honest take: it's process-heavy, but if you've ever had to clean up after ad hoc skill submissions, you'll appreciate the guardrails.

skills.sh installs: 2.2K
GitHub stars: 7.9K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add deanpeters/product-manager-skills --skill skill-authoring-workflow --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

Input

Bring the raw material and the intent — rough is fine; the workflow exists to get it the rest of the way:

Works best with: the source content (notes, transcript, framework, prompt sequence) or the existing skill you want to update
Also useful: the intended skill type (component/interactive/workflow), target audience, and any naming preference

If you supply this inline with your request (e.g., "turn research/pricing-workshop-notes.md into an interactive advisor"), the workflow starts at Phase 1 with that context — it won't re-ask for what you already gave. If you provide nothing, it opens by asking what content you want to turn into a skill and offers the entry modes from the facilitation protocol.

Example: Use skill-authoring-workflow: convert research/pricing-workshop-notes.md into an interactive pricing advisor.