Use whenever a user mentions or references a Jira ticket and you want to pull out description, comments, or more.
80
68%
Does it follow best practices?
Impact
100%
1.44xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./jira-read-ticket/SKILL.mdQuality
Discovery
57%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 establishes a clear niche around Jira ticket retrieval and includes a 'Use when' clause, which are strengths. However, it is vague about specific capabilities ('or more' is hand-wavy), lacks comprehensive trigger terms, and uses second person ('you want to pull out') which is inappropriate per the rubric guidelines.
Suggestions
List specific concrete actions beyond 'pull out description, comments, or more' — e.g., 'Retrieves Jira ticket details including description, comments, status, assignee, and linked issues.'
Add more natural trigger term variations such as 'Jira issue', 'JIRA', 'ticket key', 'project board', or patterns like 'PROJ-123'.
Rewrite in third person voice (e.g., 'Fetches Jira ticket information...') instead of second person ('you want to pull out').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It mentions some actions ('pull out description, comments, or more') but remains vague with 'or more' and doesn't list comprehensive concrete actions like creating tickets, updating status, or searching issues. | 2 / 3 |
Completeness | It has a 'when' clause ('Use whenever a user mentions or references a Jira ticket') but the 'what' is weak and vague — 'pull out description, comments, or more' doesn't clearly articulate the full capability set. | 2 / 3 |
Trigger Term Quality | Includes 'Jira ticket' as a natural keyword users would say, but misses common variations like 'Jira issue', 'JIRA', 'ticket ID', 'sprint', 'backlog', or specific Jira project key patterns. | 2 / 3 |
Distinctiveness Conflict Risk | The description is clearly scoped to Jira tickets specifically, which is a distinct niche unlikely to conflict with other skills. The Jira-specific trigger makes it easily distinguishable. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise skill that provides actionable guidance for fetching Jira data with concrete examples and clear script references. Its main weaknesses are the lack of explicit validation/error-handling steps in the workflow (e.g., checking HTTP status codes, handling auth failures) and the absence of bundle files to support the referenced scripts. The Notes section mixes several concerns that could benefit from better organization.
Suggestions
Add explicit validation checkpoints after the fetch step—e.g., check HTTP status codes (401 for bad credentials, 403 for permissions, 404 for invalid key) with recovery guidance for each.
Include the referenced scripts (scripts/fetch_comments.py, etc.) in the bundle, or add inline fallback examples so the skill works even without them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It doesn't explain what Jira is or how REST APIs work. Every section serves a purpose—environment setup, key parsing, fetching, and extraction—without padding or unnecessary context. | 3 / 3 |
Actionability | Provides concrete, executable curl commands with proper authentication headers, specific script paths with clear descriptions of what each returns, and a real JQL example. The guidance is copy-paste ready and specific. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (verify env → identify key → fetch → extract) with good structure. However, there are no explicit validation checkpoints or error-handling feedback loops—e.g., no step to verify the API response status code, handle 401/403 errors, or validate JSON output before proceeding. | 2 / 3 |
Progressive Disclosure | References three Python scripts (fetch_comments.py, fetch_assigned_tickets.py, fetch_description.py) which suggests good separation, but no bundle files are provided to verify these exist. The content is well-organized with clear sections, but the Notes section contains mixed concerns (ADF format, deprecated endpoints, security) that could be better structured or split. | 2 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
310ca43
Table of Contents
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.