issue-authoring

What problem does it solve?

This Skill enforces consistent, high-quality issue creation so trackers do not fill with vague titles, missing acceptance criteria, broken cross-references, or duplicate tickets.

Core Features & Use Cases

• Formatting and required fields enforcement: Ensures titles follow standards and descriptions include Context, Acceptance Criteria, Technical Notes, and References.
• Validation and safety checks: Queries label and assignee existence, verifies issue identifiers via issue-verify, and applies hard blocks for broken cross-references.
• Duplicate detection and workflow guidance: Searches for existing issues before creation and prompts to comment on duplicates instead of creating new tickets.
• Adapters and integration: Works with configured tracker adapters (shipped: GitHub, Jira) and requires adapter create_issue operations for final submission.
• Use Case: Convert a conversation or bug report into a tracked, triage-ready issue with validated labels, assignee, and acceptance criteria.

Quick Start

Create a new issue by providing a concise title and a description with Context, Acceptance Criteria, Technical Notes, and References, then run duplicate detection, validate labels and assignee, and call the configured adapter to create the ticket.