Smithery Logo
MCPsSkillsDocsPricing
Login
Smithery Logo

Accelerating the Agent Economy

Resources

DocumentationPrivacy PolicySystem Status

Company

PricingAboutBlog

Connect

© 2026 Smithery. All rights reserved.

    grandcamel

    jira-assistant

    grandcamel/jira-assistant
    Productivity
    3
    3 installs

    About

    SKILL.md

    Install

    Install via Skills CLI

    or add to your agent
    • Claude Code
      Claude Code
    • Codex
      Codex
    • OpenClaw
      OpenClaw
    • Cursor
      Cursor
    • Amp
      Amp
    • GitHub Copilot
      GitHub Copilot
    • Gemini CLI
      Gemini CLI
    • Kilo Code
      Kilo Code
    • Junie
      Junie
    • Replit
      Replit
    • Windsurf
      Windsurf
    • Cline
      Cline
    • Continue
      Continue
    • OpenCode
      OpenCode
    • OpenHands
      OpenHands
    • Roo Code
      Roo Code
    • Augment
      Augment
    • Goose
      Goose
    • Trae
      Trae
    • Zencoder
      Zencoder
    • Antigravity
      Antigravity
    ├─
    ├─
    └─

    About

    JIRA automation hub routing to 13 specialized skills for any JIRA task: issues, workflows, agile, search, time tracking, service management, and more.

    SKILL.md

    JIRA Assistant

    This hub routes requests to specialized JIRA skills. It does not execute JIRA operations directly—it helps find the right skill.

    Risk Levels

    Operation Risk Notes
    Route to skill - Read-only routing decision
    Skill discovery - Lists available skills
    Context tracking - In-memory only

    Risk Legend: - Safe, read-only | ! Caution, modifiable | !! Warning, destructive but recoverable | !!! Danger, irreversible

    Quick Reference

    I want to... Use this skill Risk
    Create/edit/delete a single issue, view/show issue details jira-issue ⚠️
    Search with JQL, export results jira-search -
    Change status, assign, resolve, manage versions/components jira-lifecycle ⚠️
    Manage sprints, epics, subtasks, story points jira-agile -
    Add comments, attachments, watchers jira-collaborate -
    Link issues, view dependencies, blocker chains jira-relationships -
    Log time, manage worklogs, time reports jira-time -
    Handle service desk requests, SLAs, queues, approvals, assets, knowledge base jira-jsm -
    Bulk operations on many issues (50+) with dry-run preview jira-bulk ⚠️⚠️
    Git branch names, commits, PR descriptions jira-dev -
    Custom field discovery and Agile field configuration jira-fields -
    Project discovery, cache management, diagnostics jira-ops -
    Project settings, permissions, automation rules jira-admin ⚠️⚠️

    Risk Legend: - Read-only/safe | ⚠️ Has destructive ops (confirm) | ⚠️⚠️ High-risk (confirm + dry-run)


    Routing Rules

    1. Explicit skill mention wins - If user says "use jira-agile", use it
    2. Entity signals - Issue key present → likely jira-issue or jira-lifecycle
    3. Quantity determines bulk - 50+ issues → jira-bulk (consider bulk for 10+, required for 50+)
    4. Keywords drive routing:
      • "show", "view", "display", "get", "retrieve", "see", "details", "look up", "check" (with issue reference) → jira-issue
      • "create", "update", "delete" (single issue) → jira-issue
      • "search", "find", "JQL", "filter" → jira-search
      • "sprint", "epic", "backlog", "story points", "subtask" → jira-agile
      • "transition", "move to", "assign", "close", "version", "release", "component", "resolve", "reopen", "archive" → jira-lifecycle
      • "comment", "attach", "watch", "notify", "notification", "activity", "history", "changelog" → jira-collaborate
      • "link", "blocks", "depends on", "clone", "dependency graph", "blocker chain" → jira-relationships
      • "log time", "worklog", "estimate", "time report", "timesheet" → jira-time
      • "service desk", "SLA", "customer", "request", "queue", "approval", "knowledge base", "asset" → jira-jsm
      • "branch name", "commit", "PR" → jira-dev
      • "custom field", "field ID" → jira-fields
      • "cache", "warm cache", "project discovery", "diagnostics", "performance", "request batching" → jira-ops
      • "permissions", "project settings", "automation", "automation rule", "users", "groups", "notifications", "screens", "issue types", "workflows", "notification scheme", "permission scheme" → jira-admin

    Negative Triggers

    Skill Does NOT handle Route to instead
    jira-issue Bulk (50+), transitions, comments, sprints, time jira-bulk, jira-lifecycle, jira-collaborate, jira-agile, jira-time
    jira-search Single issue lookup, issue modifications jira-issue, jira-bulk
    jira-lifecycle Field updates, bulk transitions jira-issue, jira-bulk
    jira-agile Issue CRUD (except epic/subtask), JQL, time tracking jira-issue, jira-search, jira-time
    jira-bulk Single issue ops, sprint management jira-issue, jira-agile
    jira-collaborate Field updates, bulk comments jira-issue, jira-bulk
    jira-relationships Field updates, epic/sprint linking jira-issue, jira-agile
    jira-time SLA tracking, date-based searches jira-jsm, jira-search
    jira-jsm Standard project issues, non-service-desk searches jira-issue, jira-search
    jira-dev Issue field updates, JQL searches jira-issue, jira-search
    jira-fields Field value searching, field value updates jira-search, jira-issue
    jira-ops Project configuration, issue operations jira-admin, jira-issue
    jira-admin Issue CRUD, bulk operations jira-issue, jira-bulk

    When to Clarify First

    Ask the user before routing when:

    • Request matches 2+ skills with similar likelihood
    • Request is vague or could be interpreted multiple ways
    • Destructive operations are implied

    Disambiguation Table

    Pattern Ambiguity Question Options
    "update issues" (no count) Single vs multiple "One issue or multiple?" jira-issue, jira-bulk
    "show the sprint" Details vs issues "Sprint details or issues in sprint?" jira-agile, jira-search
    "link PR" Link to JIRA or create link "Link PR to JIRA issue or create issue relationship?" jira-dev, jira-relationships
    "close them" (after search) Single vs bulk "Close all N issues found?" jira-bulk (with confirmation)
    "delete issues" Count unclear "How many issues? (One uses jira-issue, multiple uses jira-bulk)" jira-issue, jira-bulk

    Disambiguation Examples

    "Show me the sprint" Could mean:

    1. Sprint metadata (dates, goals, capacity) → jira-agile
    2. Issues in the current sprint → jira-search

    Ask: "Do you want sprint details or the issues in the sprint?"

    "Update the issue" Could mean:

    1. Change fields on one issue → jira-issue
    2. Transition status → jira-lifecycle
    3. Update multiple issues → jira-bulk

    Ask: "What would you like to update - fields, status, or multiple issues?"

    "Create an issue in the epic" Context determines:

    • Epic context explicit → jira-agile
    • Just issue creation → jira-issue

    "Find all P1 bugs and close them" Multi-step workflow:

    1. First search with jira-search to find issues
    2. Then confirm count before using jira-bulk to close

    Ask: "I found N bugs. Want me to close them all?"


    Context Awareness

    Pronoun Resolution

    When user says "it" or "that issue":

    • If exactly one issue mentioned in last 3 messages → use it
    • If multiple issues mentioned → ask: "Which issue - TES-123 or TES-456?"
    • If no issue in last 5 messages → ask: "Which issue are you referring to?"

    After CREATE:

    User: "create a bug in TES" → TES-789 created
    User: "assign it to me"
    → "it" = TES-789 (the issue just created)
    
    User: "create a bug in DEMO" → DEMO-105 created
    User: "show me the details of the bug we just created"
    → "the bug we just created" = DEMO-105 (use jira-issue to retrieve details)
    

    After SEARCH:

    User: "find all open bugs" → Found TES-100, TES-101, TES-102
    User: "close them"
    → "them" = the search results (use jira-bulk)
    

    Project Scope

    When user mentions a project:

    • Remember it for subsequent requests in this conversation
    • "Create a bug in TES" → TES is now the active project
    • "Create another bug" → Use TES implicitly
    • Explicit project mention updates the active project

    Context Expiration

    After 5+ messages or 5+ minutes since last reference:

    • Re-confirm rather than assume: "Do you mean TES-123 from earlier?"
    • Don't guess when context is stale

    Common Workflows

    Create Epic with Stories

    1. Use jira-agile to create the epic → Note epic key (e.g., TES-100)
    2. Use jira-issue to create each story with --epic TES-100 flag to link during creation
      • Alternatively: create stories first, then use jira-as agile epic add-issues to link existing issues
    3. Confirm: "Created epic TES-100 with N stories"

    Bulk Close from Search

    1. Use jira-search to find matching issues
    2. Use jira-bulk with --dry-run to preview
    3. Confirm count with user before executing

    Data Passing Between Steps

    When one skill's output feeds another:

    • Capture entity IDs from responses (e.g., epic key from jira-agile)
    • State this explicitly: "Created EPIC-123. Now creating stories..."
    • Reference captured data in subsequent operations

    Error Handling

    If a skill fails:

    • Report the error clearly
    • Suggest recovery options from docs/SAFEGUARDS.md
    • Offer alternative approaches

    If a skill is not available:

    • Acknowledge the limitation
    • Suggest alternatives from the Quick Reference table

    Permission Awareness

    Before operations that might fail due to access:

    • Check if user has mentioned permission issues before
    • Suggest jira-admin for permission checks when blocked

    Discoverability

    • /jira-assistant-skills:browse-skills - List all skills with descriptions
    • /jira-assistant-skills:skill-info <name> - Detailed skill information

    If user asks "what can you do?" or similar:

    • Show the Quick Reference table
    • Offer to explain specific skills

    What This Hub Does NOT Do

    • Execute JIRA operations directly (always delegates)
    • Guess when uncertain (asks instead)
    • Perform destructive operations without confirmation
    • Route to deprecated or unavailable skills without warning
    Recommended Servers
    ClickUp
    ClickUp
    Asana
    Asana
    GitHub
    GitHub
    Repository
    grandcamel/jira-assistant-skills
    Files