jira-to-beads

Use this skill when:

• User wants to bulk import JIRA issues into the local Beads tracker
• Converting upstream LT-* tickets to actionable work items

2. Validate Input

   • Confirm the JIRA JSON file exists and contains issues.
   • If missing or empty, stop and report the error.

3. Run Conversion Script

   • Execute the repo helper script:

     python .cache/create_beads_from_jira.py
     

   • The script:
     • Reads .cache/jira_assigned.json
     • Skips issues already mapped via external_ref
     • Creates a parent bug with the JIRA key as external_ref
   • Creates child task items with labels jira,subtask,<skill-label>
   • Wires dependencies in order: 2→1, 3→2, 4→3

4. Verify Output

   • Review script output for each JIRA key:
     • skipped if an external_ref already exists
     • created with parent and child IDs
   • If any creation failed, stop and report the error.

5. Return Summary Provide a concise summary:

   • Total created vs skipped
   • Parent and child IDs for created items
   • Any errors encountered

<child_tasks> The script creates these child tasks (do not change unless instructed):

1. Plan / design (skill: skill-plan-design)
2. Execute / implement (skill: skill-execute-implement)
3. Review (skill: skill-review)
4. Verify / test (skill: skill-verify-test) </child_tasks>

<error_handling>

• Missing JSON file: report the missing path and stop.
• No issues in JSON: report and stop.
• Beads CLI errors: surface stderr and stop.
• Partial creation: report which JIRA key failed; do not retry automatically. </error_handling>