ticket-improvement

Score GitHub issues with a rubric and draft structured rewrites with acceptance criteria.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ahlerjam/mmp --skill ticket-improvement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ticket-improvement
Source: https://github.com/ahlerjam/mmp/tree/main/skills/ticket-improvement
Command: npx skills add https://github.com/ahlerjam/mmp --skill ticket-improvement

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you upgrade low-quality or underspecified GitHub tickets into clearer, testable issue descriptions without scope creep, by scoring issues and drafting structured improvements for per-ticket approval.

Core Features & Use Cases

  • Ticket scoring with a quality rubric: Classifies tickets as GOOD, NEEDS_IMPROVEMENT, or POOR, then focuses work only where improvement is likely beneficial.
  • Structured, scope-safe rewrites: Uses a dedicated improver to draft acceptance-criteria-focused rewrites while enforcing hard rules like preserving references and never inventing acceptance criteria that weren’t implied.
  • Live or local application with race-detection: In live mode, it re-fetches and hash-compares before edits, posts a backup comment, and applies approved changes via the gh CLI; in local mode it writes final files for downstream phases.

Quick Start

Ask mmp to improve the tickets in your selected milestone by running the improve-tickets workflow and approving each ticket’s diff before applying changes.

Frequently Asked Questions about ticket-improvement

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

FAQPage Schema
How do I rewrite vague GitHub issues to include clear acceptance criteria?

To rewrite vague GitHub issues, this Skill scores each ticket with a quality rubric and drafts a structured, scope-safe rewrite with acceptance criteria. It enforces hard rules like preserving references and never inventing criteria, then requires per-ticket diff approval before applying changes.

How does race detection work when applying live edits to GitHub issues?

Race detection for live GitHub issue edits works by re-fetching the ticket and comparing a hash before applying changes. If the hash matches the previewed state, it posts a backup comment and applies approved edits through the GitHub CLI to prevent overwriting concurrent modifications.

Can I use the GitHub CLI to triage and improve tickets across an entire milestone?

Yes, you can triage and improve tickets across a milestone using the GitHub CLI. The Skill applies to milestone-based ticket triage by scoring each issue, drafting improvements, and applying approved diffs sequentially while respecting skip labels to exclude specific tickets.

What is the best way to prevent scope creep when improving underspecified GitHub tickets?

The best way to prevent scope creep when improving GitHub tickets is using a dedicated improver that drafts acceptance-criteria-focused rewrites while enforcing hard rules. It preserves existing references and never invents acceptance criteria that were not implied by the original issue.

Do I need to approve each ticket's diff before the GitHub CLI applies changes?

Yes, you need to approve each ticket's diff before changes are applied. The Skill requires per-ticket diff preview and hard approval gates, ensuring you review every structured rewrite before it is pushed to GitHub via the CLI or written locally for downstream phases.

Why are some GitHub issues skipped during automated ticket improvement?

Some GitHub issues are skipped during ticket improvement because the Skill respects skip labels configured on the tickets. If an issue is classified as GOOD by the quality rubric or carries a skip label, it focuses work only where improvement is likely beneficial.