jira-issues_skill

Overview

This skill lets you create, update, and manage Jira issues using natural language. It maps conversational commands to Jira REST API actions like creating issues, adding comments, transitioning statuses, and running JQL searches. Use it to log bugs, manage backlog items, and keep issue metadata consistent without manual API calls.

How this skill works

The skill translates plain-English instructions into Jira API requests or MCP server calls. It builds issue payloads (summary, description, type, labels, priority, assignee), runs transitions, posts comments, and executes JQL queries to fetch issues. Authentication is handled via environment variables or an MCP endpoint so requests are sent directly to your Jira instance.

When to use it

• Log a bug quickly from a chat line item
• Create a task or story without opening Jira UI
• Update issue status or transition workflows
• Add comments or attach metadata to an existing issue
• Run JQL searches like "what's on my plate" to list assigned work

Best practices

• Keep summaries under 80 characters and start with a verb
• Include clear steps to reproduce and expected vs actual behavior for bugs
• Add relevant labels for triage and filtering (frontend, backend, urgent)
• Set priority and assignee when creating actionable tickets
• Reference related issue keys and links in the description for context

Example use cases

• "Log bug about login failure on iOS" → creates a Bug with reproduction steps
• "Create task for onboarding docs" → creates Task with description, labels, priority
• "Move PROJ-123 to Done" → queries transitions and performs the status change
• "Add comment to PROJ-45: Waiting on design" → appends formatted comment to the issue
• "Show my open items" → runs JQL to return issues assigned to current user and not Done