skill-authoring-workflow
Turn raw PM content into a compliant, publish-ready skill. Use when creating or updating a repo skill without breaking standards.
npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
## 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 Firs
- Purpose
- Input
- Key Concepts
- Dogfood First
- Pick the Right Creation Path
- Definition of Done (No Exceptions)
- Facilitation Source of Truth
- Application
- Phase 1: Preflight (Avoid Duplicate Work)
- Phase 2: Generate Draft
- Phase 3: Tighten the Skill
- Phase 4: Validate Hard
- Phase 5: Integrate with Repo Docs
- Phase 6: Optional Packaging
python3 scripts/check-skill-metadata.py skills/<skill-name>/SKILL.md python3 scripts/check-skill-triggers.py skills/<skill-name>/SKILL.md --show-cases or zip one category: or use a curated starter preset: python3 scripts/check-skill-metadata.py skills/<new-skill-name>/SKILL.md
What does the skill-authoring-workflow skill do?
Turn raw PM content into a compliant, publish-ready skill. Use when creating or updating a repo skill without breaking standards.
How do I install it?
Run `npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From deanpeters/Product-Manager-Skills, a repository with 6,255 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.