pm-skill-creator — Design PM Skills Through Guided Conversations

Skill Overview

pm-skill-creator is an interactive skill design assistant. Through up to five adaptive questions, it helps you turn rough ideas, workshop notes, or product methodologies into a structurally complete, directly verifiable SKILL.md draft from scratch, all within approximately 10–15 minutes.

Use Cases

1. Turn raw content into a skill — You have workshop notes, a prompt sequence, or a framework article and want to organize it into a structured PM skill, but are unsure how to structure it.
2. Know the topic but not the structure — You want to create a new skill, such as pricing negotiation coaching or prioritization decisions, but are unfamiliar with the skill’s section conventions and metadata requirements and need step-by-step guidance.
3. Formalize a PM framework as a repository skill — Your team already has a methodology, such as a build-vs-buy matrix or a North Star Metric decision tree, and wants to codify it as a reusable, triggerable standard skill in the repository.

Core Features

1. Adaptive question-based design process — Starting with “What is the source material?” and progressing to “What are the common failure modes?”, the process asks up to five questions in sequence. If you include content when initiating the process, it uses that content as the first answer and does not ask you to repeat it.
2. Intelligent skill-type classification — Based on the form of the material in Q1, it recommends and confirms one of three types: component (single output), interactive (guided conversation), or workflow (multi-stage orchestration), avoiding the forced application of a workflow template.
3. Complete draft generation + validation guidance — The output includes YAML frontmatter (name, description, intent, type, etc.) and complete drafts of the seven required sections: Purpose, Input, Key Concepts, Application, Examples, Common Pitfalls, and References. It also provides three validation commands for metadata validation, trigger checks, and smoke testing, making clear that “generation ≠ completion.”

Frequently Asked Questions

Who is pm-skill-creator for?

It is for product managers who want to turn their own PM methodologies into AI skills, as well as skill creators who are unfamiliar with skill repository conventions and prefer guided conversation over writing against a blank document. It is a guided tool and does not require prior knowledge of the SKILL.md format.

How does it differ from skill-authoring-workflow?

They are complementary. skill-authoring-workflow defines the creation checklist and validation gates, making it suitable for people who already know what they want to build and need to execute the process step by step. pm-skill-creator is its conversational pre-work phase, helping you clarify what to build, what type it should be, what to call it, and how to organize its content before you begin. A typical use is to generate a draft with pm-skill-creator, then use skill-authoring-workflow to complete the validation process.

Does the generated draft count as complete? What else needs to be done?

No. After the draft is generated, you receive three validation commands: metadata structure validation, trigger-readiness checks, and smoke testing. All three must pass before the skill can be considered delivered. Skipping validation is one of its explicitly identified common pitfalls—invalid frontmatter, missing sections, or broken cross-file references can all prevent the skill from being triggered correctly.