sync-refs

Synchronizes session ticket statuses and pull request links from Jira and GitHub into notes frontmatter.

6|1|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill sync-refs-t-mercier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-refs
Source: https://github.com/t-mercier/ai-agents-orchestrator/tree/main/skills/sync-refs
Command: npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill sync-refs-t-mercier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ticket statuses change in the tracker and pull requests get opened long after a session's notes were written, so the frontmatter in a session's notes.md drifts out of date and the dashboard shows stale information. This Skill realigns those two facts unattended, without touching anything else. ## Core Features & Use Cases - Ticket status refresh: Queries the tracker once with a single JQL call (e.g. Atlassian MCP searchJiraIssuesUsingJql) for all tickets and rewrites the ticket_states frontmatter key using the tracker's own status wording. - Pull request discovery: Runs one gh pr list per known repository filtered locally by jq on branch names containing ticket ids, falling back to gh search prs when no repository is known, and appends new PR links without ever removing existing ones. - Use Case: The dashboard's Sync button invokes this Skill with a notes path; it reads the frontmatter, fetches current Jira statuses and GitHub PRs, rewrites only those keys, and prints a one-line English confirmation of what changed. ## Quick Start Run /sync-refs with the path to a session's notes.md file to refresh its ticket statuses and attach any missing pull request links.

Frequently Asked Questions about sync-refs

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

FAQPage Schema
How do I sync Jira ticket statuses into a notes file?

Run /sync-refs with the path to the session's notes.md. It reads the ticket ids from the frontmatter, makes one JQL query via the Atlassian MCP for all of them, and rewrites the ticket_states key with the tracker's current status wording.

How to find GitHub pull requests for Jira tickets with gh?

The Skill runs gh pr list per known repository and filters locally with jq, matching branch names against the session's ticket ids. When no repository is known, it falls back to gh search prs with the ticket ids and keeps results whose titles name a ticket.

Does sync-refs work without a Jira MCP connection?

Yes, but partially. If no tracker MCP is available, the ticket_states key is left untouched and the confirmation says so, while pull request discovery through gh still runs normally.

Why does sync-refs never remove pull request links?

PR links are append-only because a link attached by hand is a deliberate act, and a branch can be deleted while its PR still matters. Pruning links is left to the dashboard's editor, not the sync.

What happens if the notes path does not exist?

The Skill prints one line saying the path does not exist and stops. It never guesses a path, since the wrong notes.md would be rewritten with another session's references.