magnus919_agent-skills/jira-jql

Jira Query Language (JQL) — Expert Reference

The complete reference for writing, debugging, and optimizing JQL queries. Covers every operator, function, and pattern used in Jira issue search.

Why Install This Skill

When your agent loads this skill, it becomes a JQL expert who can:

• Write any JQL query — from simple field comparisons to complex date ranges and history operators
• Use all JQL functions — date/time, user, sprint/version, issue, custom field, JSM functions
• Query history — WAS, WAS IN, CHANGED operators for trend and sprint analysis
• Optimize performance — indices, avoiding expensive clauses, best practices
• Build role-specific queries — ready-made queries for developers, scrum masters, product owners, and admins
• Debug query problems — common gotchas and troubleshooting patterns

What You Get

Directory	Purpose
SKILL.md	Core syntax, operators, keywords, functions catalog
references/	Complete function catalog, role-specific query bank, gotchas & troubleshooting guide

Triggers

Load this when writing, debugging, or optimizing JQL queries; building saved filters, dashboard gadgets, or automation rules.

Requirements

None — this is a reference skill. No scripts, no API keys.

Quick Start

Start with the setup and first workflow in SKILL.md, then use the linked resources for the specific task you need to complete.