mk:jira-search

What This Skill Does

Forks the jira-search agent to run JQL queries, validate JQL, build queries from natural language, and manage saved filters. JQL is the only positional parameter on search query and search validate; everything else is flags.

When to Use

• Triggers: "search jira", "find issues where X", "jql for ...", "export search results", "manage saved filters"
• NOT for: single-issue CRUD (mk:jira-issue), bulk write ops (mk:jira-bulk).

JQL Sanitization (mandatory)

Any user-derived term embedded in JQL must pass through:

bash $CLAUDE_PROJECT_DIR/.claude/skills/jira/scripts/jql-sanitize.sh '<term>'

The sanitizer strips JQL operators / functions / special chars and quote-wraps the result. JQL injection is a real exfil class — never construct JQL from raw user input.

Verified Wrapper Invocations

Operation	Tier	Invocation
Query	1	... search query "<JQL>" --max-results 20
Validate JQL	1	... search validate "<JQL>"
Build from NL	1	... search build --description "tickets in progress for me"
Bulk update by JQL	3	... search bulk-update "<JQL>" --field labels=urgent --dry-run (always dry-run first)
Export	1	... search export "<JQL>" --output-file /tmp/out.csv --format csv
List filters	1	... filter list
Create filter	2	... filter create --name "..." --jql "<JQL>"
Delete filter	4	... filter delete <FILTER_ID>

Domain References

• references/jql-patterns.md — curated canonical templates
• references/jql-reference.md — full JQL operator + function reference
• references/search-examples.md — practical scenarios

Peer Leaves

mk:jira-bulk (write-side bulk discipline) · mk:jira-time (time-related JQL → references/jql-snippets.md)

Agent

jira-search — A + C, NOT B.