Use when adding new error messages to React, or seeing "unknown error code" warnings.
npx skills add jwmossmoz/agent-skills --skill "jira"
Install specific skill from multi-skill repository
# Description
Extract, create, and modify JIRA stories from Mozilla JIRA (mozilla-hub.atlassian.net). Use when the user asks to create JIRA stories, update JIRA issues, search for stories, list epics, add comments, or work with sprints. Supports Markdown formatting in descriptions and comments.
# SKILL.md
name: jira
description: Extract, create, and modify JIRA stories from Mozilla JIRA (mozilla-hub.atlassian.net). Use when the user asks to create JIRA stories, update JIRA issues, search for stories, list epics, add comments, or work with sprints. Supports Markdown formatting in descriptions and comments.
JIRA
Interact with Mozilla JIRA via scripts/extract_jira.py.
Prerequisites
export JIRA_API_TOKEN="your-api-token" # From https://id.atlassian.com/manage-profile/security/api-tokens
export JIRA_EMAIL="[email protected]"
Optional: JIRA_OUTPUT_DIR, JIRA_DEFAULT_PROJECT. Precedence: CLI args > env vars > config.toml > defaults.
Usage
cd scripts && uv run extract_jira.py [options]
| Operation | Command |
|---|---|
| Query current sprint | --current-sprint --summary |
| Query your issues | --my-issues |
| Query specific issue | --jql "key = RELOPS-123" |
| Create issue | --create --create-summary "Title" |
| Modify issue | --modify RELOPS-123 --set-status "In Progress" |
| Append description | --modify RELOPS-123 --append-description "New notes" |
| Edit comment | --modify RELOPS-123 --edit-comment 1242534 --comment-body "Updated content" |
| Link issues | --modify RELOPS-123 --link-issue RELOPS-456 |
| Output to stdout | --stdout --quiet |
Markdown Formatting
Use standard Markdown for descriptions and comments. The tool automatically converts Markdown to Atlassian Document Format (ADF).
DO NOT use old Jira wiki markup syntax like [text|url] - it will not render correctly.
| Element | Correct (Markdown) | Wrong (Wiki Markup) |
|---|---|---|
| Links | [text](https://url) |
[text\|https://url] |
| Bold | **text** |
*text* |
| Lists | - item or 1. item |
* item or # item |
| Code | `code` or code |
{code}code{code} |
| Headings | ## Heading |
h2. Heading |
Resources
- Full examples: references/examples.md
- All options:
uv run extract_jira.py --help - Output:
~/moz_artifacts/jira_stories.json(default)
# Supported AI Coding Agents
This skill is compatible with the SKILL.md standard and works with all major AI coding agents:
Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.