CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

62

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./project-management/skills/jira-expert/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A generally strong body: executable scripts with validation checkpoints, concrete MCP tool calls with honest boundaries on what is not MCP-capable, and clear workflows for risky operations. The main weaknesses are orphaned bundle references, an unresolvable canonical tool-list path, inlined material that duplicates the reference files, and padded/duplicated sections that inflate token cost.

Suggestions

Link the four bundled reference files from the relevant sections (e.g., 'See references/jql-examples.md' from JQL Query Building, 'See references/WORKFLOWS.md' from Workflow Design, 'See references/AUTOMATION.md and references/automation-examples.md' from Automation Rules) and trim the inlined JQL Functions Reference / Reporting Templates that duplicate them.

Make the 'canonical tool list' path resolve inside the bundle — move or copy it to references/atlassian-mcp-tools.md — since 'project-management/references/atlassian-mcp-tools.md' is not present and the body twice directs the reader to it as the authoritative source.

Cut the abstract Handoff Protocols bullet lists and de-duplicate the create-issue/JQL MCP examples (shown in both Quick Start and Atlassian MCP Integration) and the thrice-repeated 'project creation not available via MCP' note to reduce token cost.

DimensionReasoningScore

Conciseness

Mostly efficient — JQL examples, MCP calls, and tables are dense — but several sections are padded or duplicated: the abstract Handoff Protocols bullet lists, the create-issue and JQL MCP examples repeated verbatim between Quick Start and MCP Integration, and the 'not available via MCP' project-creation note stated three times. This sits between 'minor instances of over-explanation' (4) and 'several unnecessary explanations or padded sections' (2); the padding is real but a minority of the ~335 lines.

3 / 5

Actionability

Provides concrete, runnable guidance: 'python3 scripts/jql_query_builder.py "high priority bugs assigned to me" --format json', ready-to-use JQL snippets, and specific MCP tool invocations with parameters. Not fully copy-paste ready everywhere — calls use placeholder notation like 'editJiraIssue (cloudId, issueIdOrKey="MYPROG-42", fields=<payload — discover via tool schema>)' and an input-format spec for workflow.json is only partially shown — so it lands on 'mostly executable with minor gaps' rather than the fully executable 5.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation on the risky ones: bulk change requires 'Preview all changes before executing; confirm the JQL filter matches only intended issues', workflow design mandates linting with the bundled validator and 'fix every reported anti-pattern... before touching Jira' plus 'Deploy to a test project first'. Below a 5 because Dashboard Creation and Automation Rules have steps without error-recovery feedback loops (test-with-sample-data is mentioned but no fix/retry path).

4 / 5

Progressive Disclosure

Section structure is good and the two scripts are clearly signaled with usage, but all four bundled reference files (references/AUTOMATION.md, WORKFLOWS.md, automation-examples.md, jql-examples.md) are never linked from the body, and the declared 'canonical tool list' path 'project-management/references/atlassian-mcp-tools.md' does not exist in the bundle. The inlined JQL Functions Reference and Reporting Templates tables duplicate jql-examples.md — content that should live in the separate file. Between anchors 2 and 3: structure and script signaling are better than 'minimal', but the orphaned references and inlined duplicate material are a substantive organization gap.

3 / 5

Total

14

/

20

Passed

Description

83%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 description: third-person voice, concrete capability list, and an explicit, multi-trigger 'Use when' clause covering the main Jira use cases. Weaknesses are limited — a few vague filler terms ('planning, product discovery', 'all Jira features') and missing common synonyms like sprint/backlog/board.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'creating and managing projects', 'writing JQL and advanced searches', 'creating dashboards', 'designing workflows' — but pads them with vague terms like 'planning, product discovery' and the over-claim 'all Jira features', leaving minor gaps in coverage. This matches 'several specific actions; minor gaps' rather than the comprehensive, fully concrete action list of a 5.

4 / 5

Completeness

Explicitly answers both: the 'what' ('creating and managing projects... JQL queries, workflows, custom fields, automation, reporting') and an explicit 'Use when...' clause with concrete trigger phrases ('setting up or configuring Jira projects, writing JQL and advanced searches, creating dashboards, designing workflows'). The when-clause is concrete and multi-triggered, matching the top anchor exactly rather than the 'could be more explicit' level 4.

5 / 5

Trigger Term Quality

The 'Use when' clause contains natural phrases users would actually say ('setting up or configuring Jira projects', 'writing JQL', 'advanced searches', 'creating dashboards', 'designing workflows'). Common variations are missing — 'sprint', 'backlog', 'board', 'Atlassian', 'tickets/issues' — so coverage is good but not the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

'Jira' names a clear niche with distinct triggers, but 'managing projects', 'permissions' adjacency, and the catch-all 'all Jira features' create minor overlap risk with the closely related Atlassian Admin and Confluence skills referenced in the body. Mostly distinct with minor overlap, matching anchor 4 rather than the minimal-conflict 5.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.