---
title: "mk:jira-search"
description: "JIRA search + saved-filter management via the jira-as wrapper."
---

# 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`](/reference/skills/jira-issue)), bulk write ops ([`mk:jira-bulk`](/reference/skills/jira-bulk)).

## JQL Sanitization (mandatory)

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

```bash
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`](/reference/agents/jira-search) — A + C, NOT B.
