Agent skill

pm

Analyze features from user perspective and write user stories with acceptance criteria. Use when defining requirements, writing user stories, validating scope against project state, prioritizing features by impact, comparing approaches, analyzing user needs, or planning next work. Triggers: "user story", "acceptance criteria", "scope", "prioritize", "compare requirements", "user needs", "what to build next".

Stars 9
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/joaquimscosta/arkhe-claude-plugins/tree/main/plugins/roadmap/skills/pm

SKILL.md

Product Manager

Analyze features from the user perspective, write user stories, validate scope, and prioritize work.

Context Discovery

Run the shared context discovery protocol in CONTEXT_DISCOVERY.md. Execute all phases in order. Store results for use in analysis below.

Arguments

Parse from $ARGUMENTS:

Mode Description
stories <feature> Generate user stories with Given/When/Then acceptance criteria
prioritize MoSCoW prioritization with value/effort matrix
scope <feature> Feasibility and scope assessment
validate Cross-reference codebase against project goals
needs Analyze user pain points and unmet needs
compare <A> vs <B> Structured comparison of two approaches
next Recommend what to build next
(none) Ask what the user needs help with

Mode Execution

Mode Produces
stories <feature> User stories (As a/I want/So that) with Given/When/Then AC, grouped by Must/Should/Could
prioritize MoSCoW + value/effort matrix table, ranked by impact
scope <feature> Assessment: User Value, Project Fit, Dependencies, Risks, Recommendation
validate Goals vs reality cross-reference — scope creep, missing features, readiness gaps
needs User Profiles, Pain Points table, Unmet Needs, Validation Questions
compare <A> vs <B> Dimension table (value, effort, deps, risk, fit) with clear recommendation
next 1-3 prioritized features from gaps, specs pipeline, and maturity analysis

See WORKFLOW.md for detailed execution steps and output templates per mode.

Module Maturity Scale

Use the shared vocabulary in MATURITY_SCALE.md.

Output Rules

  • Default: conversational — output goes to chat
  • User-focused — every recommendation ties back to user outcomes
  • Grounded — cite specific docs, gaps, or specs when making claims
  • Honest — flag unknowns and open questions rather than guessing

File Persistence

After producing the analysis, ask the user:

Save this analysis to {output_dir}/requirements/{filename}.md?

Where {output_dir} comes from .arkhe.yaml (default: arkhe/roadmap).

Mode Filename Pattern
stories <feature> {feature-slug}-stories.md
prioritize {YYYY-MM-DD}-priorities.md
scope <feature> scope-{feature-slug}.md
validate {YYYY-MM-DD}-validation.md
needs {YYYY-MM-DD}-needs.md
compare <A> vs <B> {a-slug}-vs-{b-slug}.md
next {YYYY-MM-DD}-next.md

Deep Mode (--deep)

When $ARGUMENTS contains --deep, run the full multi-agent pipeline instead of conversational analysis. This produces reviewed, confidence-scored artifacts with cross-perspective validation.

See WORKFLOW.md § Deep Pipeline for the 5-phase execution protocol.

Patterns applied: Pipeline, Confession, Critic-Actor, Specification-First (for stories), Confidence-Gated Completion.

Lane Discipline

See the PM section of LANE_DISCIPLINE.md. Stay in your lane.

References

  • WORKFLOW.md — Detailed discovery protocol and mode workflows
  • EXAMPLES.md — Usage examples across project types
  • TROUBLESHOOTING.md — Common issues and fixes

Expand your agent's capabilities with these related and highly-rated skills.

joaquimscosta/arkhe-claude-plugins

Skill Name

What this skill does. Use when user mentions "keyword1", "keyword2", or "keyword3". Keep under 1,024 characters and include specific trigger keywords.

9 1
Explore
joaquimscosta/arkhe-claude-plugins

plugin-release-checker

9 1
Explore
joaquimscosta/arkhe-claude-plugins

skill-validator

Validate skills against Anthropic best practices for frontmatter, structure, content, file organization, hooks, MCP, and security (62 rules in 8 categories). Use when creating new skills, updating existing skills, before publishing skills, reviewing skill quality, or when user mentions "validate skill", "check skill", "skill best practices", "skill review", or "lint skill".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

sync-docs

Sync official Anthropic documentation and analyze impact on project components. Runs docs/reference/update-claude-docs.sh, computes diffs, and reports impacts on the skill validator, plugins, and project documentation. Use when user mentions "sync docs", "update reference docs", "refresh docs", or "check doc changes".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

research-frontmatter

Enforce standard YAML frontmatter on research documents in docs/research/. Use when creating, editing, or promoting research files, when user mentions "research metadata", "research frontmatter", or "research staleness".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

deep-research

Deep research on technical topics using EXA tools with intelligent two-tier caching. Use when user asks to research a topic, investigate best practices, look up information, find patterns, or explore architectures. Also invoked by /research command. Triggers: "research", "look up", "investigate", "deep dive", "find information about", "what are best practices for", "how do others implement".

9 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results