issue

Creates and matures local or remote tracker issues from user requests and implementation handoffs.

2|Updated Sep 14, 2026
One-click install
npx skills add https://github.com/kwanpham2195/agent-stuff --skill issue-kwanpham2195
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issue
Source: https://github.com/kwanpham2195/agent-stuff/tree/main/skills/issue
Command: npx skills add https://github.com/kwanpham2195/agent-stuff --skill issue-kwanpham2195

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Capturing a bug report, feature idea, or scoped work item often loses intent, duplicates existing issues, or lands in the wrong tracker. This Skill turns a plain-language request into a durable, well-structured issue in a local workspace record or an authorized remote tracker such as GitHub, preserving the user's original description and clarifying intent through targeted follow-up questions. ## Core Features & Use Cases - Request intake: Records the user's verbatim description, adds a product-facing readback, open questions, and a confidence score, then updates the issue as answers arrive. - Implementation handoff: Splits an approved plan into independently assignable issues with scope, dependencies, acceptance criteria references, and evidence requirements. - Local and remote destinations: Writes collision-safe local issue records under the workspace context directory, or creates GitHub and other configured tracker issues only after explicit destination authorization. - Promotion workflow: Publishes local issues to a remote tracker with reconciliation against prior attempts, avoiding duplicates on retry. - Use Case: A user says "Switching projects resets my filters — file this as a local issue." The Skill confirms the workspace scope, writes a stable-ID local record with the verbatim description and readback, and returns the path with open questions. ## Quick Start Use the issue skill to capture this bug report as a local workspace issue and ask me only the follow-up questions needed to make it ready.

Frequently Asked Questions about issue

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

FAQPage Schema
How do I create a GitHub issue from a bug report with an AI agent?▼

Describe the bug in plain language and authorize GitHub as the destination with a phrase like "/issue github". The Skill records your verbatim description, adds a readback and open questions, creates the issue through the configured integration, and reads it back for verification.

How do I split a plan into multiple tracker issues?▼

Ask to split the plan into local or remote issues after the plan is approved. The implementation handoff mode divides work into independently assignable outcomes with scope, dependencies, and acceptance criteria references, then creates and verifies each issue in batches.

Can I create issues locally without a GitHub account or network access?▼

Yes, local mode writes issue records as Markdown files with YAML frontmatter under the workspace context directory. It requires no network, repository, or tracker commands, and generates a stable collision-resistant ID for each record.

How does the skill avoid creating duplicate issues?▼

Before creating, it performs destination-appropriate duplicate and triage checks on existing records. On retries after partial failure, it reconciles previously created issues first and only creates the missing ones, applying the same rule to local and remote destinations.

When is an issue considered ready for implementation?▼

An issue is ready when it contains enough intent to work from and has no open critical questions. The confidence percentage reflects intake sufficiency, and drafting or creating an issue never authorizes implementation on its own.