Initial commit

skills/jira-cli/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: jira-cli
+description: Manage Jira issues via command line - read issues, query by filters, create/update issues, add comments, and close issues after work completion.
+---
+
+# jira-cli: Command-Line Jira Management
+
+Use jira-cli when interacting with Jira. Assume jira-cli already installed/configured.
+
+**Project flag:** Always use `-p PROJ` to specify project explicitly (don't rely on defaults)
+
+## When to Use
+
+**Use for:** Reading issues, querying (status/priority/assignee filters), creating/updating issues, adding comments, closing after work complete
+
+**Ask user for web UI:** Attachments/images, visual board operations (can't do from CLI)
+
+## Core Pattern: Work on Issue
+
+```bash
+jira issue view -p PROJ PROJ-123              # Read requirements
+jira issue assign PROJ-123 $(jira me)         # Assign to user
+# ... implement ...
+jira issue comment add PROJ-123 "Fixed in $(git rev-parse --short HEAD)"
+jira issue move PROJ-123 "Done"               # Close when complete
+```
+
+## Efficient Extraction
+
+Extract only needed fields to minimize context usage:
+
+```bash
+# Get specific fields only
+jira issue view -p PROJ PROJ-123 --raw | jq -r '.fields.status.name'
+
+# List keys for iteration
+jira issue list -p PROJ --plain --no-headers --columns KEY
+```
+
+## When to Load Detailed Guide
+
+Load [jira-cli reference guide](./reference/jira-cli-reference.md) for:
+- Command syntax and flags
+- Query patterns and JQL filtering
+- Output format options
+- User intent → command mapping
+- Git integration patterns