jira-sync_skill

This skill syncs plan progress to a linked JIRA ticket, posting milestones, branch and PR links to keep tickets aligned.

TypeScript

1

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill codyswanngt/lisa --skill jira-sync

SKILL.md2.3 KB

Overview

This skill synchronizes plan progress to a linked JIRA ticket. It posts plan summaries, milestone updates, branch and PR links, and suggested status transitions to keep the ticket aligned with development. Use it throughout the plan lifecycle to surface progress and avoid manual updates.

How this skill works

The skill locates a JIRA ticket from an argument or by scanning the active plan file, then fetches the current ticket state via the JIRA API. It inspects the plan and repository state to determine the milestone (plan created, implementation started, active implementation, PR ready, or PR merged). Based on that milestone it constructs a JIRA-formatted comment with branch/PR links, task completion summaries, blockers, and test results, posts the comment idempotently, and optionally updates ticket fields. Finally it reports what was synced and suggests a status transition for user confirmation.

When to use it

After creating or updating a plan to publish the plan summary to JIRA
When a working branch or tasks begin to show progress
When opening a PR to add review links and test summaries to the ticket
After merging a PR to close out work and suggest moving the ticket to Done
Periodically during long-running implementation to keep stakeholders informed

Best practices

Provide the ticket URL or ID when invoking the skill to avoid ambiguous lookups
Keep plan files up to date so the sync can accurately determine milestones and task counts
Run the sync at clear milestones (plan created, PR opened, PR merged) to keep comments focused and meaningful
Review suggested status transitions before applying them; the skill never auto-transitions tickets
Use concise headers and bullet points in plans to improve the generated JIRA comment formatting

Example use cases

Sync a newly created plan so the JIRA ticket shows the plan summary and branch link
Update the ticket when task progress changes (e.g., 3 of 5 tasks complete) to notify stakeholders
Post PR links and test results when a PR is ready for review to speed reviewer onboarding
Post final summary and recommend moving the ticket to Done after merging the PR
Run periodic syncs during active implementation to surface blockers and progress to the ticket

FAQ

No. The skill suggests status transitions based on milestone but never auto-transitions; the user must confirm any status change.

How does the skill avoid duplicate comments?

It uses idempotent update logic so repeating a sync at the same milestone updates or reuses the previous comment rather than creating duplicates.

What information does the skill add to the ticket?

Depending on milestone it can add plan summaries, task completion counts, blockers, branch names, PR links, and a final summary with a suggested status.