jira-search

Filter Jira issues using JQL queries via the REST API.

10|1|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/01000001-01001110/agent-jira-skills --skill jira-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-search
Source: https://github.com/01000001-01001110/agent-jira-skills/tree/main/jira-search
Command: npx skills add https://github.com/01000001-01001110/agent-jira-skills --skill jira-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually sifting through Jira to find specific issues or generate reports based on complex criteria is time-consuming and inefficient. This skill automates advanced searching using JQL (Jira Query Language), allowing for precise filtering and data retrieval, so you can get the insights you need instantly.

Core Features & Use Cases

  • Advanced JQL Queries: Construct and execute complex JQL queries to filter issues by project, status, assignee, date, labels, and more, with unparalleled precision.
  • Pagination & Field Selection: Efficiently retrieve large datasets with pagination and select specific fields to optimize response size, ensuring fast and relevant results.
  • Common Search Builders: Provides helper functions for common search patterns (e.g., by project, status, assignee, date range), simplifying complex queries.
  • Use Case: A project manager needs a report of all "High" priority bugs in the "Mobile App" project that were created in the last 30 days and are currently "In Progress". This skill can execute that exact query and return the relevant issues in seconds.

Quick Start

Use the jira-search skill to find all issues in the SCRUM project that are currently "To Do" and list their keys and summaries.

Frequently Asked Questions about jira-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for specific Jira issues using JQL queries?

JQL (Jira Query Language) lets you filter issues with precise criteria like project, status, assignee, and date. Use structured query syntax to find issues matching your exact conditions, then retrieve results with field selection and pagination for efficient data retrieval.

Can I generate reports from Jira by filtering issues with complex criteria?

Yes. Combine JQL filters for project, priority, status, and date range to extract specific issue sets. The skill supports pagination and field selection, enabling you to build focused reports without manual sifting.

What authentication and setup do I need to search Jira issues programmatically?

You need an authenticated JiraClient with project access to the REST API. The skill uses the /rest/api/3/search endpoint, so ensure your Jira instance credentials and permissions are configured before running queries.

How do I handle large result sets when querying Jira issues?

Use pagination with startAt and maxResults parameters to retrieve large datasets in manageable chunks. Select only the fields you need to optimize response size and improve query performance.

What common search patterns does JQL support for Jira filtering?

JQL supports filtering by project key, status state, assignee name, created date range, labels, and priority level. Helper functions simplify constructing these patterns so you can build complex multi-criteria queries quickly.

Does Jira search with JQL work for multi-project reporting?

Yes. JQL queries can span multiple projects and apply consistent filters across them. Combine project keys with other criteria to build unified reports across your Jira instance.