CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

jira

Search and manage Jira issues using JQL queries, create/update tickets, and manage workflows. Use when asked to find Jira tickets, check the backlog, manage sprints, track bugs, or work with Atlassian project management.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

65%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 well-structured CLI skill document: executable commands with thorough flag coverage, clean progressive disclosure into six verified reference files, and a solid setup-validation loop. The main costs are token duplication (Examples restate Commands; the check command's behavior is documented twice, plus a superfluous Model Guidance section) and the absence of verification steps for write/batch operations like create, update, and transitions.

Suggestions

Consolidate the redundant content: fold the "Examples" section into the Commands examples (or replace it with a pointer to references/examples.md) and merge the "Setup Verification" section with the "check" command documentation, removing the duplicated validation list and the non-actionable "Model Guidance" section.

Add explicit verification checkpoints after write and batch operations (e.g., re-run '$SKILL_DIR/scripts/jira.py issue get DEMO-123' after create/update, or 'transitions list' to confirm the new status after 'transitions do'), which would lift workflow clarity past the batch-operation cap.

Make every code block copy-paste ready: the "Examples" section uses a bare 'jira' command prefix that is never installed or defined — either use '$SKILL_DIR/scripts/jira.py' consistently or document a 'jira' alias/wrapper in the Installation section.

DimensionReasoningScore

Conciseness

The body is mostly efficient — no concept-splaining, terse flag lists, detail offloaded to references — but there is real duplication that could be tightened: the "Setup Verification" section and the later "### check" section repeat the same validation list, the ~40-line "Examples" section restates commands already shown verbatim in "Commands" (e.g., 'jira search "assignee = currentUser() AND status = Open"' and 'transitions do DEMO-123 "Done" --comment "Completed"' each appear twice), and the "Model Guidance" section adds nothing actionable. This matches anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") rather than anchor 4, where the trimming needed would be minor.

3 / 5

Actionability

The Commands section is highly concrete — full executable invocations like '$SKILL_DIR/scripts/jira.py issue create --project DEMO --type Story --summary "New story" --parent EPIC-123' with per-command flag documentation and a SKILL_DIR resolution note — covering the common cases. It falls short of anchor 5 because the "Examples" section uses a bare 'jira' prefix ('jira search ...', 'jira issue get DEMO-123') that is not a documented executable — the actual entry point is $SKILL_DIR/scripts/jira.py — so those blocks are not copy-paste ready as written, a minor gap matching anchor 4.

4 / 5

Workflow Clarity

Setup has a clear sequence with an explicit validation step and feedback loop ("If anything is missing, the check command will provide setup instructions"), but the operational workflows around risky write and batch operations — 'issue create', 'issue update', 'transitions do', batch 'issue get DEMO-1,DEMO-2,DEMO-3' — include no verification checkpoints in the body (no re-read/confirm step after a transition or create), and the rubric caps workflow clarity at 3 for batch/destructive operations lacking validation. This matches anchor 3 ("steps listed but validation gaps; checkpoints missing or implicit") and rules out 4.

3 / 5

Progressive Disclosure

The body is a clear overview-plus-core-reference that points to six well-signaled, one-level-deep reference files — configuration.md, permissions.md, examples.md (anchor link verified to a real heading), jql-reference.md, from-file-format.md, and advanced-commands.md — all of which exist in the bundle, with the only cross-reference in the bundle pointing back to SKILL.md itself. The split is appropriate (core commands inline, advanced commands, JQL patterns, config format, and examples offloaded) with each reference accompanied by a description of its content, matching anchor 5's "well-signaled one-level-deep references; content appropriately split".

5 / 5

Total

15

/

20

Passed

Description

87%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: it explicitly states multiple concrete capabilities and pairs them with an enumerated, natural-language "Use when" trigger clause, all in third-person voice. The only weaknesses are minor — a few common Jira vocabulary terms (epics, stories, boards) are missing and "manage workflows" is slightly abstract.

DimensionReasoningScore

Specificity

"Search and manage Jira issues using JQL queries, create/update tickets, and manage workflows" lists several concrete actions including the specific mechanism (JQL), but "manage workflows" is more abstract than anchor-5's fully concrete action list and capabilities like commenting, transitions, and automations are not named — minor gaps in coverage, matching anchor 4. It is clearly above anchor 3 (which expects only 1-2 concrete actions) because three-plus specific actions are given.

4 / 5

Completeness

Both parts are explicit: the "what" is "Search and manage Jira issues using JQL queries, create/update tickets, and manage workflows" and the "when" is "Use when asked to find Jira tickets, check the backlog, manage sprints, track bugs, or work with Atlassian project management" — multiple concrete trigger phrases, matching anchor 5 and the structure of the rubric's good overall examples. Not anchor 4, because the "when" clause is specific and enumerated rather than needing more explicitness.

5 / 5

Trigger Term Quality

The trigger clause includes natural phrases users would actually say — "find Jira tickets", "check the backlog", "manage sprints", "track bugs", "work with Atlassian project management" — plus the issues/tickets synonym pair across the two sentences. It falls short of anchor 5's comprehensive synonym coverage because common terms like "epics", "stories", "boards", or "agile" are absent, fitting anchor 4's "good keyword coverage; a few natural terms missing".

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche via "Jira issues", "JQL queries", "Jira tickets", and "Atlassian project management" — JQL and Atlassian are vendor-specific terms that no other tool-domain skill would claim, giving minimal conflict risk per anchor 5. It is above anchor 4 because no generic phrasing (e.g., "project management" alone) appears without the Jira/Atlassian qualifier.

5 / 5

Total

18

/

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

odyssey4me/agent-skills

Path

skills/jira/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.