skills/jira-to-gh/SKILL.md
Bridge a Jira (DAFO) ticket to the agent-native GitHub repo flow. Two modes — --mirror creates a one-to-one GH issue in RonanCodes/dataforce with linkbacks both ways; --prd seeds /ro:write-a-prd from the ticket body and publishes the PRD as a GH parent issue. Use when a Taskforce-filed DAFO ticket needs to enter the Skip+Ronan implementation pipeline.
npx skillsauth add RonanCodes/ronan-skills jira-to-ghInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
The Taskforce partners file work in Jira (DAFO board). Skip and Ronan implement in RonanCodes/dataforce using the agent-native repo pattern (ready-for-agent label, PRDs as GH issues, ralph/planner-worker consume from the queue). This skill is the bridge.
One-way by default: Jira → GitHub. Status drift is acceptable — Jira reflects the partner-facing state ("In Review" until they sign off), GH reflects the implementation state ("merged" the moment a PR lands). Skill ensures URLs are linked both ways so anyone can navigate.
/ro:jira-to-gh DAFO-42 # default: --mirror, into RonanCodes/dataforce
/ro:jira-to-gh DAFO-42 --mirror # one-to-one GH issue
/ro:jira-to-gh DAFO-42 --prd # seed /ro:write-a-prd from ticket body, publish as GH parent
/ro:jira-to-gh DAFO-42 --mirror --repo RonanCodes/some-other-repo
/ro:jira working (atlassian MCP authenticated)gh CLI authenticated against RonanCodes (or whichever target org)--prd: the /ro:write-a-prd skill installed; /ro:repo-mode resolved to personal for the target repo so the PRD publishes to GH and not .ralph/--mirror (default)For: small / well-specified DAFO tickets that map to a single agent slice.
Steps:
getJiraIssue). Capture: summary, description, type (Bug/Story/Task/Feature), labels, reporter, current status.## Source
Mirrored from Jira **DAFO-42** — https://simplicitylabs.atlassian.net/browse/DAFO-42
Reporter: <Jira reporter name>
Type: <Bug|Story|Task|Feature>
## Description
<Jira description, converted to GitHub-flavoured markdown>
gh issue create:
ready-for-agent, plus a type-derived label (bug, feature, task)Mirrored to GitHub for implementation: <gh issue URL>
Status updates will appear here when the GH issue closes.
--prdFor: larger DAFO tickets that need decomposition into vertical slices, or anything the user wants grilled with Matt Pocock's 7-section template.
Steps:
--mirror./ro:write-a-prd with the ticket body as the seed brief. The PRD interview will grill on Problem / Users / Scope / Out-of-Scope / Acceptance / Risks / Sequencing.PRD authored from this ticket: <gh parent issue URL>
Next: slicing into vertical-slice issues via /ro:slice-into-issues.
/ro:slice-into-issues <PRD#> — but do not run it automatically. User decides when to slice./ro:slice-into-issues when ready.This skill does NOT auto-sync status. Reason: Jira lifecycle (Taskforce-facing) and GH lifecycle (implementation-facing) diverge intentionally. A DAFO ticket can sit in "In Review" while three GH PRs ship and re-ship around it.
Convention:
Closes #N), the user (or a close-with-summary subagent) should run /ro:jira move DAFO-42 "In Review" and post a comment with the deploy URL./ro:jira move DAFO-42 done.The "Done means shipped" rule from the partnership chat is preserved by keeping the moves manual.
| Symptom | Cause | Fix |
|---|---|---|
| gh: command not found or auth error | gh not installed / not auth'd | Install gh, run gh auth login |
| Jira ticket fetched but description is empty | DAFO ticket was filed without body | Fetch comments too and use the first comment as description |
| Markdown formatting from Jira renders ugly on GH | Atlassian wiki markup vs GitHub MD difference | The MCP usually returns ADF/markdown; if it returns wiki markup, run through a converter or strip noise manually |
| /ro:write-a-prd opens but doesn't know about the Jira context | Seed not passed cleanly | Pre-format the brief as a single paragraph before the handoff; mention the DAFO key in the first line |
/ro:jira — basic ticket CRUD/ro:write-a-prd — Matt Pocock 7-section PRD interview, publishes to GH/ro:slice-into-issues — vertical-slice a PRD into ready-for-agent children/ro:ralph, /ro:planner-worker — consume the ready-for-agent queue[[agent-native-repo-pocock]] in llm-wiki-skill-labdevelopment
--- name: worktree description: Coordinate multiple agents on one repo via a worktree-lock pool, so two agents never clobber each other's working tree. Acquire the first free slot (main, then beta/gamma… worktrees, created on demand), work there on your own branch, release when you've pushed. Use before modifying any repo that might be in use by another agent (factory, dataforce, etc.), or whenever you're told a repo is being worked on. Backed by `ro worktree`. category: development argument-hin
testing
--- name: ship description: Ship a feature branch the local-CI-first way — run the full local gate, push, open a PR, squash-merge, then deploy, without waiting on GitHub Actions. Use when a branch is ready for main and you want it merged and deployed now. Reads CI policy from `ro ci` (default skips remote CI because GitHub Actions billing keeps hitting limits). Sibling to /ro:gh-ship (waits on GitHub checks) and /ro:cf-ship (the deploy half). Triggers on "ship it", "ship this", "merge and deploy
testing
--- name: setup-logging description: Set up (or audit) the observability stack in a TanStack Start + Cloudflare Workers app so it is "diagnosable by default" — structured logging (logtape) with a request context carrying trace_id + userId + tenant/orgId, a trace_id propagated FE→BE→logs→Sentry→PostHog, Cloudflare Workers observability enabled, and Sentry + PostHog wired. Two modes: `setup` (wire it into an app) and `audit` (check an existing app + report gaps). Use when scaffolding a new app, wh
development
Manage credentials INSIDE the active ~/.claude/.env file — read which token/account to use for a given app (Simplicity vs Dataforce vs Ronan-personal), add or update a secret WITHOUT it passing through the chat (an interactive Terminal window prompts for it), and track secrets that were exposed in a transcript so they get rotated. Sibling to /ro:context (which switches WHICH env file is active). Use when the user wants to add an API key/token/secret, asks "which credential do I use for X", needs the env organized/labelled, or a secret was pasted into the chat and should be rotated.