issue

Transform freeform PM ideas into structured GitHub issues with acceptance criteria.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/cswenor/claude-pm-toolkit --skill issue-cswenor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue
Source: https://github.com/cswenor/claude-pm-toolkit/tree/main/.claude/skills/issue
Command: npx skills add https://github.com/cswenor/claude-pm-toolkit --skill issue-cswenor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The /issue skill helps you transform freeform PM ideas into well-structured GitHub issues, ensuring clear goals, scope, and acceptance criteria before work begins.

Core Features & Use Cases

  • Create new issues (PM interview) from a casual description, with automatic deduplication and prioritization guidance.
  • Work on existing issues in Execute Mode, loading context from issue bodies, comments, and linked PRs.
  • Enforce guardrails: plan generation, acceptance criteria gates, and post-implementation checks; supports collaboration with Codex for planning.

Quick Start

Describe your goal in one sentence to create a new issue, or specify an existing issue number to work on it.

Frequently Asked Questions about issue

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

FAQPage Schema
How do I turn freeform ideas into structured GitHub issues?

To turn freeform ideas into structured GitHub issues, this Skill conducts a PM interview to extract goals, scope, and acceptance criteria. It automatically scans for duplicate issues and provides prioritization guidance before creation.

How do I execute on an existing GitHub issue and load its context?

To execute on an existing GitHub issue, provide the issue number to enter Execute Mode. This mode automatically loads context from the issue body, comments, and linked pull requests to guide your implementation work.

Does this issue planning workflow support automated duplicate checks?

Yes, this issue planning workflow supports automated duplicate checks. When creating new GitHub issues from freeform ideas, the Skill scans existing issues to prevent duplicates and enforces planning gates with optional collaborative agents.

Can I use Codex for collaborative planning when defining issue scope?

Yes, you can use Codex for collaborative planning when defining issue scope. The Skill integrates with Codex planning agents to enforce acceptance criteria gates and generate structured plans before implementation begins.

What are the guardrails for generating GitHub issues from PM ideas?

The guardrails for generating GitHub issues from PM ideas include enforced plan generation, acceptance criteria gates, and post-implementation checks. These ensure clear scope and structural alignment before development work begins.

Do I need GitHub MCP tools to automate issue creation and scanning?

Yes, you need GitHub MCP tools to automate issue creation and scanning. The Skill integrates directly with GitHub via MCP tools to read existing issue context, execute duplicate scans, and write structured issues.