Use this skill when:
- User wants to bulk import JIRA issues into the local Beads tracker
- Converting upstream LT-* tickets to actionable work items
- Validate Input
- Confirm the JIRA JSON file exists and contains issues. - If missing or empty, stop and report the error.
- 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
- 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.
- 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):
- Plan / design (skill:
skill-plan-design) - Execute / implement (skill:
skill-execute-implement) - Review (skill:
skill-review) - 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>