issue-crafting

Official

Write outcome-focused GitHub issues

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 required

Components

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.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.