Agent skill

Jira Expert

by borghei in borghei/Claude-Skills

Jira expert for project setup, workflow design, JQL queries, custom fields, automation rules, dashboards, and reporting.

MITAuto-check passedProduct & Project Management

Install Jira Expert

skills CLI
$ npx skills add borghei/Claude-Skills --skill jira-expert -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills jira-expert --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-management/jira-expert .claude/skills/jira-expert && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
jira-expert
GitHub stars
886
Token cost
~1.4k tokens
SKILL.md length
533 words
Files
9 (incl. scripts, references)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Jira expert for project setup, workflow design, JQL queries, custom fields, automation rules, dashboards, and reporting.

  • Jira configuration
  • SKILL.md covers Core Capabilities, When to Use, References and Scope & Limitations, plus 1 more section
  • Runs Python scripts from its folder
  • Advanced search

What it does

Jira Expert is an agent skill from borghei/Claude-Skills. Jira expert for project setup, workflow design, JQL queries, custom fields, automation rules, dashboards, and reporting. Use for Jira configuration, advanced search, board and dashboard creation, and technical Jira operations.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `examples/acme-50-person-eng-setup.md`, `references/automation-examples.md` and `references/jira-playbook.md`).

It sits in Product & Project Management, covering Project management. It works with Jira. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Jira configuration
  • Advanced search
  • Board and dashboard creation
  • Technical Jira operations

Example prompts

  • “/jira-expert”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • support.atlassian.com
    • jirareleases.atlassian.com
    • atlassian.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Jira Expert loads about 1.4k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 533 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 533 words, ~1,373 tokens.

Download SKILL.mdSave it as .claude/skills/jira-expert/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
jira-expert
description
Jira expert for project setup, workflow design, JQL queries, custom fields, automation rules, dashboards, and reporting. Use for Jira configuration, advanced search, board and dashboard creation, and technical Jira operations.
license
MIT + Commons Clause
metadata.version
1.0.1
metadata.author
borghei
metadata.category
project-management
metadata.domain
atlassian
metadata.updated
2026-06-15
metadata.tags
jira, jql, workflows, automation, dashboards

Atlassian Jira Expert

Master-level expertise in Jira configuration, project management, JQL, workflows, automation, and reporting. Handles all technical and operational aspects of Jira.

Terminology (Jira Cloud, as of September 2026): Jira "projects" are now called spaces and "issues" work items in the UI -- a naming change only (announcement). Existing JQL keeps working, and if a new term is not yet accepted in JQL, use the old one (project, issuetype) (JQL fields); REST paths are unchanged (/rest/api/3/project). Advanced Roadmaps is now Plans (Jira Premium and Enterprise, docs). This skill uses "project" and "space" interchangeably.

Core Capabilities

  • Project configuration — create Scrum/Kanban/custom projects, design custom workflows, configure issue types/fields/screens, set permission and security schemes
  • JQL mastery — author advanced queries, build complex filters, optimize query performance, create saved filters for teams
  • Automation & integration — design automation rules, configure webhooks and notifications, integrate Confluence/Slack/external tools
  • Reporting & dashboards — custom dashboards with gadgets, sprint/velocity/burndown reports, portfolio-level and executive reporting

When to Use

  • Setting up a new project and its workflow, fields, and board
  • Writing or debugging JQL for filters, reports, or dashboards
  • Designing automation rules and avoiding trigger loops
  • Building dashboards and configuring gadgets for a team or exec
  • Managing custom fields, issue links, security levels, or bulk operations

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/jira-playbook.md — full detail behind this map: competencies, workflows (project creation, workflow design, dashboards, automation), JQL operators/functions, advanced features (custom fields, linking, security, bulk ops), reporting templates, decision/handoff protocols, best practices, troubleshooting table, and success criteria. Read when executing any Jira task.
  • references/jql-examples.md — extended library of ready-to-run JQL queries grouped by use case (sprints, and more). Read when you need a specific query pattern fast.
  • references/automation-examples.md — concrete Jira automation rule recipes (auto-assignment, and more) with triggers/conditions/actions. Read when building or troubleshooting automation rules.
  • references/red-flags.md — common ways a Jira configuration, JQL query, automation rule, or dashboard goes wrong, with bad/good examples. Read before shipping any change to a team.
Show full SKILL.md (208 more words)Show less

Scope & Limitations

In Scope: Jira project creation and configuration, workflow design and implementation, JQL query authoring and optimization, automation rule design, dashboard and reporting setup, custom field management, board configuration, bulk operations, issue linking strategies.

Out of Scope: Org-wide Atlassian administration (hand off to atlassian-admin/), Confluence space management (hand off to confluence-expert/), sprint execution and team coaching (hand off to scrum-master/), strategic project prioritization (hand off to senior-pm/).

Limitations: Jira Cloud automation is metered as usage-based automation steps, with per-plan allowances pooled at the organization level (usage, as of September 2026). Jira Data Center reaches end of life on 28 Mar 2029 (no new/expanded DC licenses after 30 Mar 2028) -- see atlassian-admin/ and Atlassian's DC end-of-life page. Complex JQL on large instances (>100K issues) may hit performance ceilings. Workflow changes to active projects require careful migration planning -- retroactive changes do not apply to in-flight issues.

Integration Points

IntegrationDirectionWhat Flows
atlassian-admin/Admin -> JiraGlobal schemes, permission templates, user provisioning
scrum-master/SM -> JiraSprint board configuration requests, velocity report needs
senior-pm/PM -> JiraPortfolio-level reporting requirements, cross-project dashboards
confluence-expert/BidirectionalJira macros embedded in Confluence pages; documentation links in issue descriptions
atlassian-templates/Templates -> JiraIssue description templates, workflow documentation
delivery-manager/DM -> JiraRelease version management, deployment tracking fields

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (scripts, references) in project-management/jira-expert of borghei/Claude-Skills.

  • SKILL.md
  • examples/acme-50-person-eng-setup.md
  • references/automation-examples.md
  • references/jira-playbook.md
  • references/jql-examples.md
  • references/red-flags.md
  • scripts/board_optimizer.py
  • scripts/issue_quality_checker.py
  • scripts/workflow_analyzer.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Jira Expert next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Jira Expert compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Jira Expert this skillborghei/Claude-Skills886—~1.4kAutomated safety check: PassMIT
Jira Natural Language Interfacejjmartres/opencode1333 repos~1.7kAutomated safety check: PassMIT
Tidycroffasia/itsaplan913—~2.8kAutomated safety check: PassAGPL-3.0
JiraRightNow-AI/openfang18k—~694Automated safety check: PassApache-2.0
Pm Skillsalirezarezvani/claude-skills28k—~2.6kAutomated safety check: PassMIT
Product Roadmaptikalk/adlc-team-skills141—~3.1kAutomated safety check: PassMIT

Similar skills

  • Lets an agent view, create, update and transition Jira issues in natural language, automatically choosing between the jira CLI and Atlassian MCP tools.

    133 GitHub starsUsed in 3 repos~1.7k tokens
    Product & Project ManagementAuto-check passed
  • Tidy

    croffasia/itsaplan

    Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality.

    913 GitHub stars~2.8k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Jira

    RightNow-AI/openfang

    Jira project management expert for issues, sprints, workflows, and reporting

    18k GitHub stars~694 tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed
  • Pm Skills

    alirezarezvani/claude-skills

    A skill your agent uses when coordinating project-delivery work across the 8 project-management sub-skills — sprint/velocity analytics, portfolio health, Jira/JQL, Confluence, Atlassian admin…

    28k GitHub stars~2.6k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Product Roadmap

    tikalk/adlc-team-skills

    A skill your agent uses when doing weekly progress checks or milestone validation — tracks decision, execution, evidence, and gate states across four layers of truth.

    141 GitHub stars~3.1k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Project Ops

    ericrisco/rsc-harness

    A skill your agent uses when an operator wants to run a small or mid-sized project from a flat file instead of standing up Jira or Asana — dated milestones each with one named owner and a binary…

    174 GitHub stars~2.4k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Jira Expert

What does Jira Expert do?

Jira expert for project setup, workflow design, JQL queries, custom fields, automation rules, dashboards, and reporting. Jira Expert is an agent skill from borghei/Claude-Skills. Jira expert for project setup, workflow design, JQL queries, custom fields, automation rules, dashboards, and reporting.

When should I use Jira Expert?

Jira Expert fits situations like: jira configuration; advanced search; board and dashboard creation; technical Jira operations.

How do I install Jira Expert in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill jira-expert -a claude-code`. Or copy the skill folder (project-management/jira-expert in borghei/Claude-Skills) into .claude/skills/jira-expert in your project. Claude Code loads it when a task matches its description.

How do I install Jira Expert in Codex?

Run `npx skills add borghei/Claude-Skills --skill jira-expert -a codex`. Or copy the skill folder (project-management/jira-expert in borghei/Claude-Skills) into .agents/skills/jira-expert in your project. Codex loads it when a task matches its description.

Can I use Jira Expert in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill jira-expert -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/jira-expert, .gemini/skills/jira-expert, .github/skills/jira-expert and .opencode/skills/jira-expert in your project.

What does Jira Expert need to run?

Going by SKILL.md and its folder, Jira Expert needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Jira Expert access the network?

SKILL.md names 3 domains. As links in the text: support.atlassian.com, jirareleases.atlassian.com and atlassian.com. This is read from the text; nothing was executed.

Is Jira Expert safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Jira Expert use?

Jira Expert is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Jira Expert use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 10k tokens, read only when the agent opens those files.

What are the alternatives to Jira Expert?

Skills that share tags, products or a category with Jira Expert: Jira Natural Language Interface (jjmartres/opencode, 133 stars), Tidy (croffasia/itsaplan, 913 stars), Jira (RightNow-AI/openfang, 18k stars) and Pm Skills (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Jira Expert?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.