mk:jira

mk:jira — Routing Skill

This skill is a pure routing layer. Its sole purpose: identify the right mk:jira-* leaf for the user's Jira task, then point at it. No execution.

Routing Table

| User intent | Leaf skill | | -------------------------------------------- | ----------------------- | | Get/create/update/delete a single issue | mk:jira-issue | | Find issues by criteria; export; filters | mk:jira-search | | Transition through workflow; assign; resolve | mk:jira-lifecycle | | Comments, attachments, watchers, notify | mk:jira-collaborate | | Issue links, blockers, dependencies | mk:jira-relationships | | Worklogs, time tracking, time reports | mk:jira-time | | Epics, sprints, backlog, story points | mk:jira-agile | | Custom field discovery + configuration | mk:jira-fields | | Bulk ops (10+ issues, dry-run mandatory) | mk:jira-bulk | | Service Management (queues, SLAs, customers) | mk:jira-jsm | | Project/user/group/scheme administration | mk:jira-admin | | Git/PR/branch-name integration | mk:jira-dev | | Cache + project-context discovery | mk:jira-ops | | Evaluate ticket complexity + inconsistencies | mk:jira-evaluator | | Estimate story points (heuristic) | mk:jira-estimator | | Analyze ticket context + media; RCA | mk:jira-analyst |

Setup

See references/install-and-auth.md for one-time setup (.claude/scripts/bin/setup-workflow installs jira-as into .claude/skills/.venv; populate .claude/.env with the 3 MEOW_JIRA_* vars).

Shared Resources (used by leaves)

• scripts/jira-as.sh — env-translating wrapper (MEOW_JIRA_* → JIRA_*, sets JIRA_OUTPUT=json)
• scripts/jql-sanitize.sh — JQL escaping for user-derived terms
• scripts/requirements.txt — pip dependency manifest auto-discovered by .claude/scripts/bin/setup-workflow
• references/install-and-auth.md — setup, exit codes, DC/mTLS caveats
• references/cli-idioms.md — verified jira-as syntax + jq projection rules
• references/safety-framework.md — 4-tier safety model
• references/evaluation-rubric.md — used by mk:jira-evaluator
• references/estimation-guide.md — used by mk:jira-estimator
• references/field-discovery.md — used by mk:jira-fields (moved from jira/references/)

Handoff

• mk:intake → recommends mk:jira-* leaf based on triage
• mk:cook (build pipeline) → may invoke mk:jira-issue to create implementation tickets
• mk:ship (ship pipeline) → may invoke mk:jira-dev for branch-name + PR-description
• mk:planning-engine → consumes Jira tickets via this hub for sprint planning analysis (mk:jira-evaluator / mk:jira-estimator outputs enrich the planning report)
• mk:confluence → sister hub for Confluence Cloud; mk:planning-engine accepts both Jira tickets (--tickets) and Confluence specs (--spec <report-path>) as input

Gotchas

• mk:jira itself never executes; if you're in this skill thinking about jira-as commands, you're in the wrong place — forward to a leaf.
• Escape hatch: if jira-as is unusable (mTLS, multi-profile), users may invoke Atlassian MCP directly per references/install-and-auth.md. The router does NOT auto-fallback.