CtrlK
BlogDocsLog inGet started
Tessl Logo

jira-read-ticket

Use whenever a user mentions or references a Jira ticket and you want to pull out description, comments, or more.

80

1.44x
Quality

68%

Does it follow best practices?

Impact

100%

1.44x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./jira-read-ticket/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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').

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
bkircher/skills
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.