How do I install the Issue skill?

Run npx skillmds@latest add mike-diff/issue-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Issue safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Issue?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Issue free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

mike-diff (@mike-diff) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Issue by mike-diff — Agent Skill

Name: Issue
Author: mike-diff

Issue

Fetch a GitHub issue, explore the codebase, ask clarifying questions, and produce an implementation plan. Stops before building — hand off to /dev when ready. Use when planning implementation from a GitHub issue.

mike-diff 6c68881 2 files · 11.9 KB Updated Sep 17, 2026

File contents

/issue — GitHub Issue Analysis & Planning

Analyse a GitHub issue, explore the codebase, clarify ambiguities, and produce a detailed implementation plan. Stops before implementation — hand off to /dev when ready.

Phases

#	Phase	What happens
1	Fetch	Parse input (number or URL), fetch issue via `gh issue view`
2	Detect	Identify tech stack from manifest files
3	Explore	Delegate to the built-in Explore subagent, get affected files and patterns
4	Clarify	Present understanding, ask questions — STOP for user input
5	Plan	Create implementation plan with AI risk assessment
6	Todo	Generate task list via TodoWrite, then STOP

Key Constraints

MUST fetch the issue using gh CLI
Delegate wide codebase exploration to the built-in Explore subagent; explore directly only when the area is already known
MUST stop after creating the todo list — do NOT implement
Use sequential-thinking MCP for complex planning decisions
Use context7 MCP for library documentation lookups

Handoff

When complete:

/dev "Implement #[issue-number]" @[plan file if saved]

Full Workflow

For complete phase-by-phase instructions, gh commands, exploration prompts, plan format, and AI assessment template, see references/workflow.md.

Frequently asked questions