jwmossmoz

jira

3
0
# Install this skill:
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.