Name: jira-expert
Rating: 70.39999999999999 (1 reviews)
Author: alirezarezvani

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

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

The canonical home for this skill is jira-expert in alirezarezvani/claude-skills

Quality

Content

83%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 content is highly actionable and well-structured with strong validation feedback loops in its workflows, and it stays lean without over-explaining Jira basics. Its main defect is progressive disclosure: the body repeatedly references bundled scripts and a reference file that are not present in the skill bundle.

Suggestions

Ship the referenced bundle files: add `scripts/jql_query_builder.py`, `scripts/workflow_validator.py`, and `references/atlassian-mcp-tools.md` (or remove the invocations and inline the equivalent guidance) so navigation targets exist.

Resolve the cross-skill reference path: `project-management/references/atlassian-mcp-tools.md` appears to live outside this skill's directory — either vendor a local copy or restate the canonical tool list inline.

Consider moving the long JQL Functions / Reporting Templates tables into a dedicated reference file to keep SKILL.md a true overview, since these are lookup material rather than getting-started content.

Dimension	Reasoning	Score
Conciseness	The body is dense and largely efficient — concrete tool calls, JQL snippets, and terse lists with little concept over-explanation — though a few enumerated basics (Common Operators, Permission Schemes bullet lists) could be trimmed slightly.	4 / 5
Actionability	Provides copy-paste-ready, executable guidance: real MCP tool call signatures with arguments, runnable `python3 scripts/...` commands with expected output, and concrete JQL examples covering common cases.	5 / 5
Workflow Clarity	Multi-step workflows (Project Creation, Workflow Design, Bulk Operations) are explicitly sequenced with Validate checkpoints and feedback loops (validate -> fix -> retry; preview-before-execute), satisfying the strict validation requirement for destructive/batch operations.	5 / 5
Progressive Disclosure	The body is well-sectioned and signals one-level-deep references to `scripts/jql_query_builder.py`, `scripts/workflow_validator.py`, and `project-management/references/atlassian-mcp-tools.md`, but the referenced `references/`, `scripts/`, and `assets/` bundles do not actually exist in this skill, so the navigation points to missing files.	3 / 5
	Total	17 / 20 Passed

Description

88%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.

The description is strong: it concisely enumerates concrete capabilities and pairs them with an explicit, natural 'Use when...' trigger clause covering the main Jira operational scenarios. Its only weakness is minor overlap risk with sibling Atlassian skills and a few missing trigger synonyms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions across the domain ('creating and managing projects, planning, product discovery, JQL queries, workflows, custom fields, automation, reporting') plus 'writing JQL and advanced searches, creating dashboards, designing workflows', giving comprehensive coverage of specific actions.	5 / 5
Completeness	Explicitly answers both 'what' (the long capability list) and 'when' via a clear 'Use when setting up or configuring Jira projects, writing JQL and advanced searches...' clause with concrete trigger phrases.	5 / 5
Trigger Term Quality	Strong natural keywords users would say ('setting up or configuring Jira projects', 'writing JQL', 'creating dashboards', 'designing workflows'), but a few common synonyms or file/extension variations are absent, keeping it just below comprehensive.	4 / 5
Distinctiveness Conflict Risk	'Atlassian Jira expert' carves a clear niche with distinct technical-operation triggers; minor overlap risk with closely related Atlassian Admin / Confluence skills, but JQL/dashboard/workflow triggers are largely Jira-specific.	4 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 4 missing	Warning

	Total	15 / 16 Passed

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

Reviewed: ~8 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.