skills/jira/SKILL.md
Search, create, modify, comment, link, or transition issues in Mozilla JIRA (mozilla-hub.atlassian.net) via the extract_jira.py script. Markdown → ADF conversion is built in. Prefer this skill over the Atlassian MCP for JIRA work — it handles RELOPS defaults, sprint queries, comment edit/append, and bulk modify with dry-run.
npx skillsauth add jwmossmoz/agent-skills jiraInstall 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.
Interact with Mozilla JIRA via scripts/extract_jira.py.
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.
uv run ~/.claude/skills/jira/scripts/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 |
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 |
When creating JIRA stories, follow this workflow:
/humanizer to remove AI writing patterns from the description text--create# 1. Draft description (you do this in memory)
# 2. Run humanizer on the description
# 3. Create story with humanized description
uv run ~/.claude/skills/jira/scripts/extract_jira.py --create \
--create-summary "Implement new feature" \
--description "The feature adds capability to process tasks. It handles edge cases and provides error handling." \
--epic-create RELOPS-2019
Use /humanizer to remove AI writing patterns from story descriptions before submitting.
*bold*, [text|url], h2.). The script converts Markdown to ADF; wiki markup renders as raw text./humanizer on the description before --create — JIRA stories surface to other humans, and AI tells.JIRA_API_TOKEN is account-scoped. JIRA_EMAIL must match the token owner; mismatched email gives an opaque 401.--jql "project = X AND ..." to query other projects.uv run ~/.claude/skills/jira/scripts/extract_jira.py --help~/moz_artifacts/jira_stories.json (default)development
Download Azure Cost Management exports and query local Parquet/CSV in DuckDB. Use when refreshing local Azure cost caches or writing DuckDB SQL over exports. DO NOT USE FOR live Cost Management API diagnosis; use azure-cost-analysis.
data-ai
Use when creating performance self-reviews from local notes, prior reviews, review prompts, and verified evidence. Helps draft H1/H2, annual, and promotion self evaluations, example answers, and rich review-form paste output. Do not use for routine status or 1:1 summaries; use one-on-one.
tools
Prepare one-on-one/status bullets from ~/moz_artifacts using qmd and copy a topic-organized HTML/RTF list with embedded links to the macOS clipboard. Use when summarizing recent Mozilla work for a manager, 1:1, or status update. DO NOT USE FOR generating raw daily logs; use daily-log.
development
Use when tracing Taskcluster Azure VM startup from worker-manager request through in-VM boot scripts to generic-worker `workerReady` with tc-logview, paperctl, Splunk Web, and Yardstick Prometheus. Applies to Windows worker provisioning latency. DO NOT USE FOR task failure triage (use worker-image-investigation).