Agent skill

Utility Pm Workflow Builder

by product-on-purpose in product-on-purpose/pm-skills

Guides a contributor from a workflow idea to a complete Workflow Implementation Packet (draft workflow file, draft workflow command, cross-cutting update checklist) in a staging area for review.

Apache-2.0Auto-check passedAgent Workflows

Install Utility Pm Workflow Builder

skills CLI
$ npx skills add product-on-purpose/pm-skills --skill utility-pm-workflow-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install product-on-purpose/pm-skills utility-pm-workflow-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/product-on-purpose/pm-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/utility-pm-workflow-builder .claude/skills/utility-pm-workflow-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
utility-pm-workflow-builder
GitHub stars
715
Token cost
~2.2k tokens
SKILL.md length
947 words
Files
4 (incl. references)
Skills in repo
68
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guides a contributor from a workflow idea to a complete Workflow Implementation Packet (draft workflow file, draft workflow command, cross-cutting update checklist) in a staging area for review.

  • Works in 5 steps: Understand the Idea → Overlap Analysis + Why Gate → Sequence Design → …
  • Creating a new multi-skill workflow
  • SKILL.md covers When to Use, When NOT to Use, Instructions and Output Format, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Utility Pm Workflow Builder is an agent skill from product-on-purpose/pm-skills. Guides a contributor from a workflow idea to a complete Workflow Implementation Packet (draft workflow file, draft workflow command, cross-cutting update checklist) in a staging area for review. Runs overlap analysis against the existing workflows with a Why Gate, then helps select and sequence skills with authored handoffs. Use when creating a new multi-skill workflow or promoting a repeated ad-hoc chain into a durable one. To build a single skill instead, use utility-pm-skill-builder; to run a sequence without…

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `evals/trigger-fixtures.json`, `references/EXAMPLE.md` and `references/TEMPLATE.md`).

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: 68 plug-and-play, best-practice product management skills for AI agents: 30 Triple Diamond phase + 11 foundation + 12 utility + 15 tool (Foundation Sprint + Design Sprint). Plus… The licence is Apache-2.0.

When your agent uses it

  • Creating a new multi-skill workflow
  • Promoting a repeated ad-hoc chain into a durable one

Example prompts

  • “Use the utility-pm-workflow-builder skill to guide a contributor from a workflow idea to a complete Workflow Implementation Packet (draft workflow…”
  • “/utility-pm-workflow-builder”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Understand the Idea
  2. Overlap Analysis + Why Gate
  3. Sequence Design
  4. Generate the Packet
  5. Review + Promotion Guidance

What it can do on your machine

Read from SKILL.md and the folder at commit 1cef1a9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Utility Pm Workflow Builder loads about 2.2k tokens when it runs, and up to ~7.1k if it reads all its reference files. Until then it costs about 156 tokens; SKILL.md has 947 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~156
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from product-on-purpose/pm-skills at commit 1cef1a9, republished under its Apache-2.0 licence (© product-on-purpose). 947 words, ~2,203 tokens.

Download SKILL.mdSave it as .claude/skills/utility-pm-workflow-builder/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
utility-pm-workflow-builder
description
Guides a contributor from a workflow idea to a complete Workflow Implementation Packet (draft workflow file, draft workflow command, cross-cutting update checklist) in a staging area for review. Runs overlap analysis against the existing workflows with a Why Gate, then helps select and sequence skills with authored handoffs. Use when creating a new multi-skill workflow or promoting a repeated ad-hoc chain into a durable one. To build a single skill instead, use utility-pm-skill-builder; to run a sequence without authoring anything, use the chain command or utility-pm-workflow-orchestrator.
license
Apache-2.0
metadata.classification
utility
metadata.version
1.0.0
metadata.updated
2026-06-10
metadata.category
workflow
metadata.frameworks
triple-diamond
metadata.author
product-on-purpose
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->

PM Workflow Builder

This skill creates new multi-skill workflows for the pm-skills library. It produces a Workflow Implementation Packet - a draft _workflows/<name>.md file, a draft commands/workflow-<name>.md command, and the cross-cutting update checklist - in a staging area for review before promotion to canonical locations. The builder authors; it never executes a chain and it never promotes its own output.

When to Use

  • You have an idea for a new multi-skill workflow ("I need a workflow for quarterly business reviews")
  • You know the skills you want to chain and want them captured durably ("chain competitive-analysis, experiment-results, pivot-decision")
  • A /chain run (orchestrator Mode B) proved reusable and its completion output suggested promoting the chain to a durable workflow; hand this skill the exact chain expression from that suggestion

When NOT to Use

  • To run a sequence once without authoring anything -> use the /chain command or utility-pm-workflow-orchestrator directly
  • To build or modify a single skill -> use utility-pm-skill-builder, utility-pm-skill-validate, or utility-pm-skill-iterate
  • To customize an existing workflow -> edit its _workflows/<name>.md directly; the overlap analysis below will point you there when coverage is high

Instructions

Step 1: Understand the Idea

Accept the idea in any of three entry forms, all converging on the same downstream flow:

  • Problem-first: "I need a workflow for X." Identify the recurring PM process, who runs it, and the artifact trail it should leave.
  • Skills-first: a list of skills the user already wants to chain.
  • Chain-promotion: a literal chain expression (for example measure-experiment-results -> discover-stakeholder-summary), usually pasted from the orchestrator's completion suggestion, plus the context the run used.

If the idea is vague, ask ONE clarifying question (the recurring trigger and the final artifact), then proceed. Do not interrogate.

Step 2: Overlap Analysis + Why Gate

Scan the _workflows/ directory at run time for the current inventory (list every *.md except README.md). Never rely on a remembered count or a hardcoded list. Compare the idea against ALL existing workflows:

  • Name each overlapping workflow and what it covers.
  • Estimate coverage overlap honestly.

Kill gate (>70% coverage overlap): recommend, in order, (a) customizing the existing workflow, (b) adding a step to it, or (c) just using /chain for the occasional run. Do not proceed.

Why Gate (any meaningful overlap): ask for 2-3 specific scenarios where the existing workflows fail to produce what is needed. Do not pass the gate without that evidence or an explicit user override (record the override in the packet's Decision section).

Step 3: Sequence Design

Select and order the steps with the user. Apply the chain-expression contract's validation rules at authoring time (skills/utility-pm-workflow-orchestrator/references/PARSE-CONTRACT.md, Mode B Chain Expression Contract):

  • Every step must resolve to an installed skill at skills/<name>/SKILL.md by EXACT name. Never approximate or auto-correct; on a miss, refuse the step and OFFER the closest real names (an offer, never a substitution).
  • Category 1 content skills only. Refuse as steps, each with a one-line explanation: Tier-3 maintenance skills (utility-pm-skill-*, utility-pm-release-conductor, utility-pm-changelog-curator, utility-update-pm-skills, foundation-prioritized-action-plan), dispatch skills that fan out to sub-agents (utility-pm-critic, utility-pm-workflow-orchestrator, and peers), and existing workflows (a workflow never nests a workflow). Self-reference is impossible by construction: this builder is itself Tier-3.
  • For EACH step, author the handoff: what the step consumes from the prior step's output, and what it must produce for the next. This authored handoff guidance is exactly what distinguishes a durable workflow from an ad-hoc chain; a packet without real handoffs is not ready.
Show full SKILL.md (391 more words)Show less
Step 4: Generate the Packet

Write the complete Workflow Implementation Packet to _staging/workflows/<name>/ (gitignored; the same review model as the skill builder). Never write to canonical locations.

_staging/workflows/<name>/
├── workflow.md      <- draft _workflows/<name>.md
├── command.md       <- draft commands/workflow-<name>.md
└── PACKET.md        <- decision, overlap analysis, checklist, promotion steps

Use references/TEMPLATE.md as the packet format. The workflow draft must carry the full section inventory the current _workflows/*.md files share (see the TEMPLATE's embedded skeleton); the command draft mirrors the existing commands/workflow-*.md shape, including one literal skills/<name>/SKILL.md path per step and the $ARGUMENTS footer. Derive a linear mermaid context-flow diagram from the final sequence (step names as nodes, execution order as edges).

Step 5: Review + Promotion Guidance

Present the packet and stop. The builder itself never promotes. On approval, the user (or a follow-up session) moves the drafts to their canonical paths and works the packet's Cross-Cutting Checklist, which names every count and documentation surface that adding a workflow trips, including the validator-blind .github/workflows/release.yml release-note template. The builder never edits those cross-cutting files itself.

Output Format

The packet follows references/TEMPLATE.md:

  1. Decision - recommendation plus Why Gate evidence (or the recorded override)
  2. Overlap Analysis - every overlapping workflow, what it covers, the gap
  3. Workflow Draft - complete _workflows/<name>.md content
  4. Command Draft - complete commands/workflow-<name>.md content
  5. Cross-Cutting Checklist - every surface to update at promotion, with its enforcing validator (or "validator-blind" where none exists)
  6. Promotion Steps - the move-verify-validate sequence

See references/EXAMPLE.md for one complete worked packet.

Quality Checklist

Before presenting the packet, verify:

  • Overlap analysis scanned the live _workflows/ directory (no remembered list, no hardcoded count)
  • Why Gate evidence is specific (named scenarios) or an explicit override is recorded
  • Every step resolves to an installed skill by exact name
  • No Tier-3 maintenance skill, dispatch skill, or workflow appears as a step
  • Every step has an authored handoff (consumes / produces), not just a skill name
  • The workflow draft carries every section in the TEMPLATE's skeleton (metadata table, When to Use with Do NOT use, per-step blocks, context-flow diagram, tips, quality checklist, see also)
  • The command draft names each step's skills/<name>/SKILL.md path and ends with the $ARGUMENTS footer
  • The mermaid diagram matches the final sequence exactly
  • Everything written under _staging/workflows/<name>/; no canonical path touched
  • The Cross-Cutting Checklist is reproduced in full, including the .github/workflows/release.yml release-note row

Reference Files

© product-on-purpose, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/utility-pm-workflow-builder of product-on-purpose/pm-skills.

  • SKILL.md
  • evals/trigger-fixtures.json
  • references/EXAMPLE.md
  • references/TEMPLATE.md

Open the folder on GitHubat commit 1cef1a9

Compare with similar skills

Utility Pm Workflow Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Utility Pm Workflow Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Utility Pm Workflow Builder this skillproduct-on-purpose/pm-skills715—~2.2kAutomated safety check: PassApache-2.0
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    66k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from product-on-purpose/pm-skills

All 68 skills in this repo
  • Define Hypothesis

    product-on-purpose/pm-skills

    Defines a testable hypothesis with clear success metrics and a validation approach.

    715 GitHub stars~966 tokensUpdated yesterday
    Auto-check passed
  • Define Jtbd Canvas

    product-on-purpose/pm-skills

    Creates a Jobs to be Done canvas capturing the functional, emotional, and social dimensions of a customer job.

    715 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Define Opportunity Tree

    product-on-purpose/pm-skills

    Creates an opportunity solution tree connecting a desired outcome to customer opportunities and candidate solutions, preventing solution-first jumps in continuous discovery.

    715 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Define Problem Statement

    product-on-purpose/pm-skills

    Creates a clear problem framing document with user impact, business context, and success criteria.

    715 GitHub stars~932 tokensUpdated yesterday
    Auto-check passed
  • Deliver Acceptance Criteria

    product-on-purpose/pm-skills

    Generates structured Given/When/Then acceptance criteria for a user story or feature slice, covering the happy path, key failure scenarios, and non-functional expectations in testable form.

    715 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Deliver Launch Checklist

    product-on-purpose/pm-skills

    Creates a cross-functional pre-launch checklist covering engineering, design, marketing, support, legal, and operations readiness, with owners, dates, and go/no-go criteria so nothing is missed…

    715 GitHub stars~970 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Utility Pm Workflow Builder

What does Utility Pm Workflow Builder do?

Guides a contributor from a workflow idea to a complete Workflow Implementation Packet (draft workflow file, draft workflow command, cross-cutting update checklist) in a staging area for review. Utility Pm Workflow Builder is an agent skill from product-on-purpose/pm-skills. Guides a contributor from a workflow idea to a complete Workflow Implementation Packet (draft workflow file, draft workflow command, cross-cutting update checklist) in a staging area for review.

When should I use Utility Pm Workflow Builder?

Utility Pm Workflow Builder fits situations like: creating a new multi-skill workflow; promoting a repeated ad-hoc chain into a durable one.

How do I install Utility Pm Workflow Builder in Claude Code?

Run `npx skills add product-on-purpose/pm-skills --skill utility-pm-workflow-builder -a claude-code`. Or copy the skill folder (skills/utility-pm-workflow-builder in product-on-purpose/pm-skills) into .claude/skills/utility-pm-workflow-builder in your project. Claude Code loads it when a task matches its description.

How do I install Utility Pm Workflow Builder in Codex?

Run `npx skills add product-on-purpose/pm-skills --skill utility-pm-workflow-builder -a codex`. Or copy the skill folder (skills/utility-pm-workflow-builder in product-on-purpose/pm-skills) into .agents/skills/utility-pm-workflow-builder in your project. Codex loads it when a task matches its description.

Can I use Utility Pm Workflow Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add product-on-purpose/pm-skills --skill utility-pm-workflow-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/utility-pm-workflow-builder, .gemini/skills/utility-pm-workflow-builder, .github/skills/utility-pm-workflow-builder and .opencode/skills/utility-pm-workflow-builder in your project.

What does Utility Pm Workflow Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Utility Pm Workflow Builder is instructions for the agent only.

Does Utility Pm Workflow Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Utility Pm Workflow Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Utility Pm Workflow Builder use?

Utility Pm Workflow Builder is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Utility Pm Workflow Builder use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.9k tokens, read only when the agent opens those files.

What are the alternatives to Utility Pm Workflow Builder?

Skills that share tags, products or a category with Utility Pm Workflow Builder: Skill Creator (Azure/azqr, 795 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Utility Pm Workflow Builder?

product-on-purpose (a GitHub organization) maintains it in product-on-purpose/pm-skills, which has 715 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on October 8, 2026.

Source: product-on-purpose/pm-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.