templates/issues/.agents/skills/jql-queries/SKILL.md
How to construct JQL (Jira Query Language) queries. Use when searching for issues with complex filters, or when the user asks for issues by type, status, assignee, sprint, label, or date ranges.
npx skillsauth add BuilderIO/agent-native jql-queriesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
JQL (Jira Query Language) is how you search for issues in Jira. Use it with the search-issues script:
pnpm action search-issues --jql "issuetype = Bug AND status != Done"
issuetype = Bug
issuetype = Story
issuetype in (Bug, Task)
issuetype != Epic
status = "In Progress"
status != Done
status in ("To Do", "In Progress")
status was "In Progress"
statusCategory = "In Progress"
statusCategory != Done
assignee = currentUser()
assignee = "john.doe"
assignee is EMPTY
assignee is not EMPTY
project = PROJ
project in (PROJ, ENG, DESIGN)
sprint in openSprints()
sprint in futureSprints()
sprint in closedSprints()
sprint = "Sprint 42"
labels = "frontend"
labels in ("frontend", "backend")
labels is EMPTY
created >= -7d
updated >= -1d
created >= "2024-01-01" AND created <= "2024-03-31"
resolutiondate >= startOfMonth()
duedate <= endOfWeek()
priority = High
priority in (High, Highest)
priority >= Medium
summary ~ "login bug"
text ~ "authentication"
description ~ "API endpoint"
Use AND, OR, and parentheses:
project = PROJ AND issuetype = Bug AND status != Done
(assignee = currentUser() OR reporter = currentUser()) AND status = "In Progress"
project = PROJ AND sprint in openSprints() AND statusCategory != Done
ORDER BY created DESC
ORDER BY priority DESC, created ASC
ORDER BY updated DESC
My open bugs:
assignee = currentUser() AND issuetype = Bug AND resolution = Unresolved
Unresolved issues in current sprint:
sprint in openSprints() AND resolution = Unresolved ORDER BY priority DESC
Issues created this week:
project = PROJ AND created >= startOfWeek() ORDER BY created DESC
High-priority unassigned:
priority in (High, Highest) AND assignee is EMPTY AND resolution = Unresolved
Recently updated bugs:
issuetype = Bug AND updated >= -3d ORDER BY updated DESC
status = "In Progress"currentUser() for the logged-in userstartOfDay(), endOfDay(), startOfWeek(), startOfMonth(), -7d (relative)~ is the "contains" operator for text fieldsresolution = Unresolved means the issue is still opentools
Public booking flow — the state machine, animations, and URL/app-state sync.
tools
Trigger-based automations — reminders, follow-ups, webhooks — across the booking lifecycle.
tools
Team event types, round-robin assignment, collective bookings, host weights, and no-show calibration.
development
The pure `computeAvailableSlots` function — inputs, outputs, invariants, and debugging guide.