// Jira issue tracking and project management. Use for creating, searching, updating, and commenting on Jira issues. Supports JQL queries for advanced searching.
| name | jira-tasks |
| description | Jira issue tracking and project management. Use for creating, searching, updating, and commenting on Jira issues. Supports JQL queries for advanced searching. |
| allowed-tools | Bash(python *) |
Set these environment variables:
JIRA_URL — Your Jira instance URL (e.g., https://yourcompany.atlassian.net)JIRA_EMAIL — Your Atlassian account emailJIRA_API_TOKEN — API token from https://id.atlassian.com/manage-profile/security/api-tokensAll scripts are in .claude/skills/jira-tasks/scripts/
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "JQL_QUERY" [--max-results N]
# Examples:
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "type = Bug AND status != Done AND created >= -7d"
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "labels = question AND created >= -30d" --max-results 50
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "assignee = currentUser() AND status = 'In Progress'"
The jira_client.py module provides:
| Function | Purpose |
|---|---|
search_issues(jql, max_results) | Search issues using JQL |
get_issue(issue_key) | Get issue details |
create_issue(project, summary, ...) | Create a new issue |
update_issue(issue_key, fields) | Update an existing issue |
add_comment(issue_key, comment) | Add a comment to an issue |
# Recent bugs
type = Bug AND created >= -7d ORDER BY created DESC
# Open tasks
status != Done AND status != Closed
# By label
labels IN ("helpdesk", "question")
# Text search
summary ~ "timeout" OR description ~ "timeout"
# Assigned to me
assignee = currentUser() AND status != Done
# Stale issues
updated <= -90d AND status != Done
| Operator | Meaning | Example |
|---|---|---|
| = | Equals | status = Done |
| != | Not equals | status != Done |
| ~ | Contains text | summary ~ "error" |
| IN | In list | status IN ("Open", "In Progress") |
| >= | Greater/equal | created >= -7d |
| ORDER BY | Sort | ORDER BY created DESC |
python search_issues.py --jql "text ~ 'authentication timeout' AND created >= -30d"
from jira_client import create_issue
create_issue(
project="HELP",
summary="Update knowledge base — refund policy",
description="A customer asked about the refund timeline and our docs were outdated.",
issue_type="Task",
priority="Medium",
)
python search_issues.py --jql "labels = helpdesk AND created >= -30d" --max-results 100
| Goal | Command |
|---|---|
| Search issues | search_issues.py --jql "type = Bug" |
| Recent issues | search_issues.py --jql "created >= -7d" |
| By label | search_issues.py --jql "labels = helpdesk" |
AWS service troubleshooting patterns. Use for EC2, ECS, Lambda, CloudWatch, RDS issues.
Search and read Confluence documentation. Use when looking for internal docs, knowledge base articles, runbooks, or team documentation stored in Confluence.
PostgreSQL database inspection and queries. Use when investigating table schemas, running queries, checking locks, replication status, or long-running queries.
Correlate incidents with recent deployments and code changes. Use when investigating if a deployment caused an issue, finding what changed, or identifying the commit that introduced a bug.
GitHub code search, file reading, PR review, branch/file management, and commit operations. Use when you need to search code patterns, read repository files, review pull requests, create branches, commit files, or open PRs.
Kubernetes debugging methodology and scripts. Use for pod crashes, CrashLoopBackOff, OOMKilled, deployment issues, resource problems, or container failures.