● Communauté
netresearch
⚡ Instantané
jira-skill
par netresearch · netresearch/jira-skill
Two skills (jira-communication + jira-syntax) wrapping Jira Server/DC and Cloud APIs via shell — issues, JQL, sprints, worklogs, attachments, no Docker needed.
A Claude Code skill pack for Jira with no container dependency. jira-communication covers API operations (get / update / search by JQL / transition / comment / link / worklog / attach / board + sprint management). jira-syntax helps with Jira wiki markup. Works with Server/DC and Cloud via env-based credentials, includes an interactive jira-setup.py for config.
Pourquoi l'utiliser
Fonctionnalités clés
- Works with Jira Server, DC, and Cloud
- No Docker — pure shell + Python
- Full issue lifecycle: create, transition, comment, link, worklog, attach
- JQL search helpers
- Sprint + board management
- Interactive
jira-setup.py credential configurator - jira-syntax helper for wiki markup
Démo en direct
Aperçu en pratique
Cas d'usage
Usages concrets : jira-skill
Quand l'utiliser : Mid-sprint when velocity is dropping and you suspect blockers.
Déroulement
-
List sprint issues by status
Use jira-skill. List issues in sprint 'Sprint 42' grouped by status. Flag anything not updated in 3 days.✓ Copié
→ Grouped table with staleness markers
-
Drill into blockers
For the blocked issues, pull the last comment and linked issues — who's waiting on what?✓ Copié
→ Dependency summary
-
Nudge owners
Draft a comment on each blocked issue pinging the responsible party.✓ Copié
→ Per-issue drafts
Résultat : A clear list of unblock actions to drive in standup.
Pièges
- Over-pinging — comments cost attention — Let Claude draft; post manually only the ones that matter
Quand l'utiliser : Cutting a release and need user-facing notes from the issue list.
Déroulement
-
JQL for the release
JQL: fixVersion = 1.42 AND status = Done. Pull summaries and types.✓ Copié
→ Ordered issue list
-
Draft notes
Group by type (Feature / Bug / Improvement) and write user-facing release notes — no internal jargon.✓ Copié
→ Markdown notes ready to publish
Résultat : Release notes in minutes instead of hours.
Quand l'utiliser : Moving a batch of issues between statuses (e.g. deploy-complete).
Déroulement
-
Dry-run first
Find all 'In Staging' issues with fixVersion = 1.42. Don't transition yet — just list.✓ Copié
→ List to confirm
-
Transition
Transition those to 'Done' with a comment 'Deployed to production in 1.42'.✓ Copié
→ Per-issue transition result
Résultat : Clean workflow state, nothing left in 'In Staging'.
Pièges
- Missing required fields on transition — Skill surfaces the required field; supply it in the prompt
Quand l'utiliser : Month-end capacity review.
Déroulement
-
Query worklogs
Pull all worklogs for team members in project ACME for last month.✓ Copié
→ Per-person, per-issue hour totals
-
Summarize
Roll up to epic and share of total.✓ Copié
→ Top-level breakdown
Résultat : Capacity picture grounded in actual logged work.
Pièges
- Worklogs aren't filled in — bad data — Flag people with 0 logs; don't draw conclusions from missing data
Combinaisons
Associez-le à d'autres MCPs pour un effet X10
Link PRs to Jira issues or create Jira issues from GitHub bugs
For each GitHub issue labeled 'bug' opened this week, create a Jira ticket in project ACME.✓ Copié
Coût et limites
Coût d'exécution
- Quota d'API
- Jira Cloud: 10 req/sec per user typical; Server/DC is instance-configured
- Tokens par appel
- Low — mostly API responses
- Monétaire
- Free skill; Jira license separate
- Astuce
- Use JQL server-side filters rather than pulling all and filtering client-side
Sécurité
Permissions, secrets, portée
Portées minimales : Read project; write only where needed (transition/comment)
Stockage des identifiants : JIRA_URL + JIRA_USER + JIRA_TOKEN in env; don't check into git
Sortie de données : Only to your Jira host
Ne jamais accorder : Admin on the instance
- API tokens for Cloud should be user-scoped; for Server/DC use personal access tokens, not passwords.
Dépannage
Erreurs courantes et correctifs
401 Unauthorized
Token missing or revoked; re-run jira-setup.py
Vérifier : curl -u $JIRA_USER:$JIRA_TOKEN $JIRA_URL/rest/api/2/myself
400 on transition
Transition requires a field you didn't provide — inspect transitions with get_transitions
Search returns 0 but issues exist
Your JQL or project permissions; verify the user can see the project
Alternatives
jira-skill vs autres
| Alternative | Quand l'utiliser | Compromis |
| Atlassian's official MCP | You prefer first-party integration | Less control over shell access |