issue-crafting
OfficialWrite outcome-focused GitHub issues
Software Engineering#github#issue#acceptance-criteria#duplicate-detection#issue-crafting#label-discovery
Authorsynaptiai
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Many GitHub issues conflate desired outcomes with implementation details, which narrows the solution space and makes verification difficult. This Skill helps authors gather the right context, avoid implementation language, detect duplicates, and produce acceptance criteria that are observable and verifiable.
Core Features & Use Cases
- Solution-agnostic issue writing: Guides authors to describe outcomes, not methods, and to rewrite implementation-centric wording into outcome statements.
- Duplicate detection and label discovery: Walks through searching open and closed issues and selecting labels dynamically from the repository's label set.
- Verification and milestone suggestions: Recommends milestones if present and provides a checklist-style issue body with observable acceptance criteria.
- Use Case: A product manager drafting a bug report provides context and current state; the Skill searches for duplicates, suggests labels and milestones, and returns a clear issue body with verifiable acceptance criteria.
Quick Start
Ask the agent to craft a GitHub issue by providing Context, Current State, Objective, and Acceptance Criteria and request duplicate detection, label suggestions, and milestone recommendations.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: issue-crafting Download link: https://github.com/synaptiai/synapti-marketplace/archive/main.zip#issue-crafting Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.