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.
94
Quality
94%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that excels across all dimensions. It provides specific actions, includes natural trigger terms users would actually say, explicitly states both what the skill does and when to use it, and has clear distinctiveness through Jira/Atlassian-specific terminology.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Search and manage Jira issues using JQL queries, create/update tickets, and manage workflows' - covers searching, creating, updating, and workflow management. | 3 / 3 |
Completeness | Clearly answers both what ('Search and manage Jira issues using JQL queries, create/update tickets, and manage workflows') AND when ('Use when asked to find Jira tickets, check the backlog, manage sprints, track bugs, or work with Atlassian project management'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Jira tickets', 'backlog', 'sprints', 'bugs', 'Atlassian', 'project management', 'JQL queries' - these are terms users naturally use when working with Jira. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche with distinct triggers specific to Jira/Atlassian ecosystem - 'JQL queries', 'Jira tickets', 'sprints', 'Atlassian' are highly specific and unlikely to conflict with other project management or ticketing skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%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, highly actionable skill with excellent workflow clarity and progressive disclosure. The main weakness is moderate verbosity - some sections could be tightened without losing clarity, particularly the authentication and configuration sections which repeat similar patterns. Overall, it provides comprehensive, executable guidance for Jira integration.
Suggestions
Consolidate the authentication section by presenting environment variables and config file options more concisely, perhaps in a table format rather than separate subsections with full code blocks for each
Remove explanatory text that describes what commands do when the command output or example already makes it obvious (e.g., 'This validates: Python dependencies are installed...' after showing the check command)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some unnecessary verbosity, such as explaining what the check command validates in detail and repeating similar patterns across sections. Some sections like authentication options could be more condensed. | 2 / 3 |
Actionability | Provides fully executable commands throughout with specific examples, copy-paste ready bash commands, and concrete configuration file examples. Every command includes clear arguments and real usage patterns. | 3 / 3 |
Workflow Clarity | Multi-step processes include explicit verification steps (e.g., 'Create the issue' then 'Verify it was created correctly', 'Check available transitions first' before transitioning). The check command provides a clear validation checkpoint for setup. | 3 / 3 |
Progressive Disclosure | Well-structured with clear overview sections and appropriate references to separate files (permissions.md, scriptrunner.md, examples.md, jql-reference.md). References are one level deep and clearly signaled with descriptive links. | 3 / 3 |
Total | 11 / 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.
Install with Tessl CLI
npx tessl i odyssey4me/jira@0.3.1Reviewed
Table of Contents