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>