Back to Skills

utility-pm-critic

product-on-purpose
Updated 2 days ago
8 views
238
33
238
View on GitHub
Metaai

About

This skill performs adversarial reviews on product management artifacts, returning prioritized findings (P0-P3) with concrete fixes. It works natively on Claude Code via a plugin and falls back to inline execution on other IDEs/CLIs. The output includes a layered status summary and a machine-readable YAML block.

Quick Install

Claude Code

Recommended
Primary
npx skills add product-on-purpose/pm-skills -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/product-on-purpose/pm-skills
Git CloneAlternative
git clone https://github.com/product-on-purpose/pm-skills.git ~/.claude/skills/utility-pm-critic

Copy and paste this command in Claude Code to install this skill

Documentation

<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->

PM Critic (Dispatch Skill)

This skill is a cross-client dispatch wrapper for the pm-critic sub-agent. It exists so that users on non-Claude clients can run adversarial review with the same intent as Claude Code users, without depending on native plugin sub-agent infrastructure.

Per master plan D11 (amended) + D30, sub-agents are a Claude Code plugin feature. Non-Claude clients (Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI) cannot natively load subagents/pm-critic.md. This skill bridges the gap.

When to Use

  • You want adversarial review of a PM artifact (PRD, OKR set, persona, lean canvas, meeting recap, interview synthesis, problem statement, hypothesis, edge case catalog, retrospective, etc.)
  • You are running on a non-Claude AI client and the pm-critic sub-agent is not natively available
  • You are running on Claude Code and prefer skill-invocation semantics over sub-agent semantics (e.g., for consistency across a multi-step workflow that mixes skills and sub-agent intents)

When NOT to Use

  • You want a structural lint / repo-level audit -> use utility-pm-skill-auditor (audits skills + repo state) instead
  • You want to author an artifact (this skill only reviews) -> use the appropriate phase skill (deliver-prd, foundation-okr-writer, etc.)
  • You want code review -> use a code-review-specific tool (this skill is for PM artifacts)
  • You want to enforce style rules like em-dash sweep -> that is pm-release-conductor's G0 gate, not this skill

Instructions

Runtime detection step. Determine which AI client is invoking this skill.

If you are running in Claude Code with the pm-skills plugin installed

Invoke @agent-pm-critic on the target artifact. Pass the artifact path as argument (or the most recent artifact in session context if no argument is provided). Return the sub-agent's findings to the user. No further action needed from this skill - the sub-agent handles the review natively in its own context window.

If you are running in any other AI client

Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI, ChatGPT, or any other client without native pm-skills plugin sub-agent support:

  1. Read the canonical sub-agent definition at subagents/pm-critic.md
  2. Execute the system prompt body in that file as your operating instructions for this turn
  3. Read the target PM artifact specified by the user (path from $ARGUMENTS, or most recently produced artifact in session)
  4. Read the canonical standards docs referenced by the pm-critic system prompt for the artifact type (e.g., skills/foundation-okr-writer/SKILL.md for OKR sets, skills/deliver-prd/SKILL.md for PRDs)
  5. Produce findings graded P0/P1/P2/P3 with concrete fix suggestions, formatted per the output structure documented in docs/guides/adversarial-review.md
  6. End the output with the layered structure per master plan D26:
    • Section (1): full human-readable findings (the P0/P1/P2/P3 report)
    • Section (2): ## Status Summary in prose, summarizing what was found and what the user should do next
    • Section (3): ## Status YAML block with machine-readable fields

Output Format

See references/TEMPLATE.md for the canonical output structure (with the layered Status envelope per D26). See references/EXAMPLE.md for a worked example showing a real cross-client dispatch run against a PRD.

Composition

  • Skills: This dispatch skill composes with all PM-artifact-producing skills (deliver-prd, foundation-okr-writer, foundation-meeting-recap, foundation-persona, foundation-lean-canvas, discover-interview-synthesis, etc.). Run any of those, then run this skill on the produced artifact.
  • Sub-agents: On Claude Code, this skill dispatches to pm-critic sub-agent. On non-Claude, this skill IS the inline execution; no further dispatch.
  • Workflows: Once pm-workflow-orchestrator (v2.17) ships, workflows can invoke this skill at quality-gate steps for cross-client compatibility.

Cross-Client Notes

Per master plan D30, dispatch skill availability in v2.16.0 is CONDITIONAL on Phase 2 GATE B spike outcomes. If the dispatch mechanism is reliable on Codex CLI + Cursor + Windsurf + Copilot + Gemini CLI, this skill ships. If unreliable on any specific client, that client falls back to either codex-rescue (Claude Code + Codex CLI users) or manual reading of subagents/pm-critic.md.

The "read and execute inline" pattern depends on the AI being able to:

  1. Read a file path provided as a reference (most AI clients support this)
  2. Treat that file's content as operating instructions for the current turn (most AI clients support this for SKILL.md-style instructions)
  3. Read additional referenced standards docs at invocation time (all major AI clients support this)

If any of these are unreliable on a given client, that client cannot use this dispatch skill effectively.

Reference Files

GitHub Repository

product-on-purpose/pm-skills
Path: skills/utility-pm-critic
0
agent-skillsai-skillsclaude-codeclaude-desktopdesign-sprintfoundation-sprint

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill