jira-expert

Atlassian Jira expert for creating and managing projects, planning, product discovery, JQL queries, workflows, custom fields, automation, reporting, and all Jira features. Use when setting up or configuring Jira projects, writing JQL and advanced searches, creating dashboards, designing workflows, or performing technical Jira operations.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly executable with well-sequenced, validation-gated workflows and concrete MCP/JQL/script examples. Its main weakness is progressive disclosure: the canonical reference path it cites does not exist and the actual bundle reference files are never surfaced or linked.

Suggestions

Replace the non-existent `project-management/references/atlassian-mcp-tools.md` citations with a real file (or create it) so the 'canonical tool list' reference resolves.

Link the existing reference bundle files from SKILL.md — e.g. point the Workflow Design and Automation Rules sections at WORKFLOWS.md / AUTOMATION.md / automation-examples.md, and the JQL examples at jql-examples.md — so detailed material lives one level deep instead of inlined.

Trim the inlined Reporting Templates and JQL examples now duplicated by jql-examples.md, keeping only a couple of representative snippets in SKILL.md and pointing to the reference for the rest.

Dimension	Reasoning	Score
Conciseness	Largely lean and executable with no padding about what Jira/PDF-style concepts are, but sections like the bare link-type lists, permission-scheme names, and handoff protocol inventories restate domain knowledge Claude already has and could be trimmed.	4 / 5
Actionability	Fully executable guidance throughout — exact MCP calls with example arguments, real bundled scripts invoked with precise syntax (e.g. `python3 scripts/jql_query_builder.py "..." --format json`), and copy-paste JQL covering common cases; the few '<discover via tool schema>' placeholders are explicitly justified rather than pseudocode.	5 / 5
Workflow Clarity	Multi-step workflows (Workflow Design, Bulk Operations) are clearly sequenced with explicit validation checkpoints and feedback loops — 'Lint the design before building', 'Deploy to a test project first; verify all transitions', and 'Validate: Preview all changes before executing... bulk edits are difficult to reverse'.	5 / 5
Progressive Disclosure	The body repeatedly designates `project-management/references/atlassian-mcp-tools.md` as the 'canonical tool list', yet that path does not exist in the bundle, while the four real reference files (AUTOMATION.md, WORKFLOWS.md, automation-examples.md, jql-examples.md) are never linked; JQL/automation/reporting content that belongs in those files is inlined instead, so references are effectively buried and navigation is broken.	2 / 5
	Total	16 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that pairs a comprehensive enumeration of Jira capabilities with an explicit 'Use when' trigger clause. It is specific, naturally triggered, and clearly distinct from sibling skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'creating and managing projects, planning, product discovery, JQL queries, workflows, custom fields, automation, reporting' — giving comprehensive coverage of Jira capabilities rather than vague abstraction.	5 / 5
Completeness	Explicitly answers both 'what' (the enumerated capabilities) and 'when' via a concrete 'Use when setting up or configuring Jira projects, writing JQL... or performing technical Jira operations' clause.	5 / 5
Trigger Term Quality	Natural trigger phrases users would actually say — 'setting up or configuring Jira projects', 'writing JQL and advanced searches', 'creating dashboards', 'designing workflows' — cover the domain's common request phrasings comprehensively.	5 / 5
Distinctiveness Conflict Risk	'Atlassian Jira expert' is a clear niche with distinctive triggers (Jira, JQL, Jira projects/dashboards/workflows) and minimal overlap risk with unrelated skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: alirezarezvani/claude-skills
Path: project-management/skills/jira-expert/SKILL.md
Commit: 19392f7

Reviewed: ~2 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.