utility-pm-skill-builder

Generates staged Skill Implementation Packets for new pm-skills library skills.

640|81|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-pm-skill-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: utility-pm-skill-builder
Source: https://github.com/product-on-purpose/pm-skills/tree/main/skills/utility-pm-skill-builder
Command: npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-pm-skill-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creating a new skill for the pm-skills library requires gap analysis against the full catalog, correct classification, convention-compliant files, and eval assets - doing this by hand leads to duplicated skills, drifted structures, and missing eval coverage.

Core Features & Use Cases

  • Gap Analysis with Why Gate: Scans the live skill inventory from skill-manifest.json or AGENTS.md across all four families (domain, foundation, utility, tool) and challenges overlapping ideas with a Why Gate and Kill Gate before any drafting begins.
  • Classification and Dialect Selection: Classifies the idea as domain, foundation, or utility, assigns the directory naming convention, and picks one of the three sanctioned skeleton dialects plus structural exemplars.
  • Eval-Ready Packet Generation: Produces a complete Skill Implementation Packet with draft SKILL.md, TEMPLATE.md, EXAMPLE.md, command file, trigger-fixtures.json, and output-scenario files, written to a gitignored staging area and promoted to canonical locations after CI validation.
  • Use Case: A contributor wants to add a win-loss analysis skill. The builder checks the catalog for overlap, classifies it as a discover-phase domain skill, drafts all files including eval fixtures, stages them for review, and promotes them after lint and collision checks pass.

Quick Start

Ask the assistant to use the pm-skill-builder skill to evaluate your new PM skill idea and generate a staged Skill Implementation Packet for review.

Frequently Asked Questions about utility-pm-skill-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new skill for the pm-skills library?

Use the pm-skill-builder skill, which runs gap analysis against the live catalog, validates the idea through a Why Gate, classifies it by type and phase, and generates a staged Skill Implementation Packet with all draft files for review before promotion.

What files does a new pm-skills skill need?

A new skill needs SKILL.md with valid frontmatter, references/TEMPLATE.md, references/EXAMPLE.md, a command file, an AGENTS.md entry, plus eval assets: evals/trigger-fixtures.json for routing and evals/output-scenarios for output quality.

When should I not use the pm-skill-builder?

Do not use it to modify an existing skill (use utility-pm-skill-iterate), audit a skill against conventions (use utility-pm-skill-validate), author workflows, or build skills for non-pm-skills contexts.

How does the builder decide between domain, foundation, and utility skills?

Domain skills are phase-specific PM activities using a phase-prefixed directory and a phase frontmatter field. Foundation skills are cross-cutting and utility skills are repo tooling; both use a classification field and their respective directory prefixes.

What happens if my skill idea overlaps with an existing skill?

The builder triggers a Why Gate asking for 2-3 specific prompts where existing skills fail. Without convincing evidence, the Kill Gate recommends revising an existing skill, creating a workflow, or adding a command variant instead.

How are new skills validated before promotion?

Promotion runs frontmatter linting, AGENTS.md and command validators, trigger-fixture and output-eval asset gates, reciprocal boundary pointer checks, and a collision probe confirming the new skill recalls its own triggers without stealing neighbors'.