workflow-ticket

Creates and refines GitHub workflow issues with scoped contracts and project tracking.

Updated Dec 18, 2025
One-click install
npx skills add https://github.com/l0lxl0lw/dotfiles --skill workflow-ticket-l0lxl0lw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-ticket
Source: https://github.com/l0lxl0lw/dotfiles/tree/main/opencode/skills/workflow/workflow-ticket
Command: npx skills add https://github.com/l0lxl0lw/dotfiles --skill workflow-ticket-l0lxl0lw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a vague feature or bug request into a well-scoped GitHub issue requires clarifying requirements, capturing decisions, and wiring up project tracking. This Skill structures that ticket-definition stage so issues carry a clear contract before any technical research begins. ## Core Features & Use Cases - Scoped requirement gathering: Asks a small batch of decision-bearing questions about interface, identity, invalid inputs, persistence, and verification, then captures a concise contract with acceptance examples. - GitHub issue lifecycle: Creates new issues with gh issue create, or updates an existing issue only after explicit user confirmation, preserving prior content and status. - Project and Orca tracking: Adds issues to the configured project, sets Backlog status, links Orca via track.py link-orca, and records verified contract checkpoints with handoff.py. - Use Case: A user says "/ticket add rate limiting to the API". The Skill asks targeted scoping questions, drafts the issue body, creates the GitHub issue assigned to the user, attaches it to the configured project and Orca, and records a v2 contract for the research stage. ## Quick Start Ask the assistant to create a ticket for the feature or bug you have in mind, for example by saying "/ticket add pagination to the users endpoint".

Frequently Asked Questions about workflow-ticket

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

FAQPage Schema
How do I create a well-scoped GitHub issue from a vague feature request?

Invoke the ticket workflow with your request, and it asks 3-6 decision-bearing questions about interface, identity, invalid inputs, and verification. It then drafts a concise contract with acceptance examples and creates the issue via gh issue create.

How does the ticket workflow handle an existing similar GitHub issue?

Similar issues are treated as references, not edit targets. Before any gh issue edit, the workflow shows the candidate and asks whether to create a new ticket, update the existing one, or cancel; only explicit approval authorizes the update.

Does the ticket workflow integrate with GitHub Projects and Orca tracking?

Yes. After creating an issue it adds it to the configured project with track.py add, sets Status to Backlog, runs track.py link-orca for Orca attachment, and mirrors the milestone with checkpoint-orca. Each outcome is reported independently.

What happens if Orca linking fails during ticket creation?

An Orca failure does not undo the created issue or skip project setup. On a link conflict you choose to keep the existing link or replace it; orca_unavailable or failed statuses are reported with the helper's exact recovery command.

When should technical investigation happen relative to ticket creation?

Technical investigation belongs in the research stage, not the ticket stage. The ticket captures product scope, decisions, and unresolved technical questions, then hands off via handoff.py packet so research starts from a verified contract.