Skills
mk:jira-search
JIRA search + saved-filter management via the jira-as wrapper.
| Source | .claude/skills/jira-search/SKILL.md |
| Owner | jira |
| Runtime | claude-code |
| Risk | medium |
| Phase | on-demand |
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 templatesreferences/jql-reference.md— full JQL operator + function referencereferences/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.