JQL Query Builder

Construct and validate JQL queries for Jira issue searches.

2|1|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/sethdford/claude-plugins --skill jql-query-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: JQL Query Builder
Source: https://github.com/sethdford/claude-plugins/tree/main/jira-plugin/.claude-plugin/skills/jql-query-builder
Command: npx skills add https://github.com/sethdford/claude-plugins --skill jql-query-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps construct and optimize JQL queries to search and filter Jira issues efficiently, saving time and reducing misfilters.

Core Features & Use Cases

  • Query construction: Build complex filters step by step with explanations.
  • Syntax guidance: Explain operators, fields, and functions.
  • Testing & refinement: Validate queries with /jira-search and refine results.
  • Use Case: Find recently updated high-priority bugs assigned to you.

Quick Start

Tell me a search goal, for example: "Find all high-priority bugs assigned to me updated in the last 7 days," and I will generate and explain a JQL query.

Frequently Asked Questions about JQL Query Builder

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

FAQPage Schema
How do I write a JQL query to filter Jira issues by multiple criteria?

JQL queries filter Jira issues by combining multiple criteria using AND, OR, and NOT operators. Specify fields like project, status, priority, assignee, and dates in a single query to locate bugs, features, or tasks matching your exact requirements without manual browsing.

What operators and functions does JQL support for advanced searches?

JQL supports comparison operators (=, !=, <, >), logical operators (AND, OR, NOT), and specialized functions for dates and user fields. These enable precise filtering by updated date ranges, assignee groups, and complex status combinations to narrow results efficiently.

Can I search for recently updated high-priority bugs assigned to me in Jira?

Yes. Use JQL to combine assignee, priority, type, and date functions in a single query—for example, filtering by assignee = currentUser(), priority = High, type = Bug, and updated >= -7d to find high-priority bugs updated in the last week.

How do I test and refine a JQL query to ensure it returns correct results?

Construct your JQL query step by step, then validate it by executing the search in Jira. Review the results and adjust field names, operators, or logical conditions iteratively until the query returns only the issues you need.

What's the difference between using JQL filters versus manual Jira issue browsing?

JQL queries execute searches across multiple projects and fields simultaneously with reproducible, shareable syntax, whereas manual browsing is slower and difficult to repeat. JQL scales to complex multi-criteria searches that would take minutes to filter manually.

Do I need Jira admin access to create and save JQL queries?

No. Any Jira user can construct and execute JQL queries in the search interface. Admin access is only required to create shared filters or dashboards that persist queries organization-wide.