mark-ticket-as-done

Transition Jira tickets or GitHub Projects v2 items to developer-done with PR-linked comments.

Updated May 4, 2026
One-click install
npx skills add https://github.com/mhert/claude-code-helpers --skill mark-ticket-as-done
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mark-ticket-as-done
Source: https://github.com/mhert/claude-code-helpers/tree/main/skills/mark-ticket-as-done
Command: npx skills add https://github.com/mhert/claude-code-helpers --skill mark-ticket-as-done

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, acli, marklassian, jq, node, and includes assets (resource) components.

What problem does it solve?

It removes the manual, error-prone work of updating Jira workflow states or GitHub Projects v2 Status values after PRs are opened, while ensuring stakeholders get a clear comment that links every involved PR.

Core Features & Use Cases

  • Automated tracker transition: Moves a Jira ticket forward via workflow transition by name, or updates a GitHub issue’s Projects v2 Status field option by name.
  • Stakeholder-ready, exhaustive PR comment: Posts a markdown comment (converted to ADF for Jira) containing the ticket summary, affected features, verification steps, and a mandatory list of every PR involved.
  • Safety guardrails: Confirms the ticket, target status, PR links, and comment type, prevents replay on already-transitioned items, and validates project configuration (GitHub) before writing.

Quick Start

Run mark-ticket-as-done with the Jira key or GitHub issue identifier for the ticket whose PRs are already open, and provide or confirm the PR URLs and the target developer-done status name.

Frequently Asked Questions about mark-ticket-as-done

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

FAQPage Schema
How do I transition Jira tickets to done automatically when PRs are opened?

To transition Jira tickets to done, this Skill applies workflow transitions by name after PRs are opened, posting an exhaustive stakeholder comment linking every related PR. It resolves the tracker type and target status at runtime to ensure accurate end-to-end ticket closure preparation.

Can I update GitHub Projects v2 status fields automatically after opening a pull request?

You can update GitHub Projects v2 status fields automatically after opening a pull request. The Skill validates your project configuration and updates the Status field option by name, ensuring consistent state transitions across your repositories.

How to post stakeholder comments linking multiple PRs to a Jira ticket workflow transition?

Posting stakeholder comments linking multiple PRs during a Jira ticket workflow transition involves converting markdown to Atlassian Document Format. The Skill generates a comment containing the ticket summary, affected features, verification steps, and a mandatory list of every involved PR.

Does this ticket workflow automation support idempotency for already transitioned Jira or GitHub issues?

Yes, this ticket workflow automation supports idempotency by validating state and preventing replay on already-transitioned Jira or GitHub issues. It confirms the ticket, target status, PR links, and comment type before executing any status updates or posting comments.

What dependencies do I need to automate Jira and GitHub ticket status transitions with PR comments?

Automating Jira and GitHub ticket status transitions requires installing gh, acli, marklassian, jq, and node. These dependencies facilitate CLI interactions, Atlassian Document Format conversion, JSON parsing, and runtime execution for staged automation across platforms.

Best way to ensure consistent ticket closure preparation across multiple repos with Jira and GitHub Projects?

The best way to ensure consistent ticket closure preparation across multiple repos is using staged automation with label-first status updates. This approach applies additive updates and validates existing project workflow configuration before writing changes to Jira or GitHub Projects v2.