# Skill Authoring Workflow

Turn raw PM content into a compliant, publish-ready skill.

- Repository: https://github.com/deanpeters/Product-Manager-Skills (7825 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-16
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -g -a claude-code -y`
Codex: `npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -g -a codex -y`
Cursor: `npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -g -a cursor -y`
Gemini CLI: `npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add deanpeters/Product-Manager-Skills`

## Description

Turn raw PM content into a compliant, publish-ready skill. Use when creating or updating a repo skill without breaking standards.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 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.`

## 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

- **Guided wizard (`build-a-skill.sh`)**: Best when you have an idea but not final prose.
- **Content-first generator (`add-a-skill.sh`)**: Best when you already have source content.
- **Manual edit + validate**: Best for tightening an existing skill.

### Definition of Done (No Exceptions)

The rest: https://github.com/deanpeters/Product-Manager-Skills/blob/HEAD/skills/skill-authoring-workflow/SKILL.md