CtrlK
BlogDocsLog inGet started
Tessl Logo

auto-jira

Autonomously work on Jira backlog tickets, creating PRs and shepherding them to merge

52

Quality

58%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/auto-jira/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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 strong, well-structured skill that provides clear, actionable guidance for autonomous Jira ticket processing. The workflow is explicit with proper validation checkpoints and error recovery paths. Minor verbosity in the attribution table and Critic agent templates could be tightened, but overall the skill is effective and well-organized.

DimensionReasoningScore

Conciseness

The skill is generally well-structured and avoids explaining basic concepts, but includes some redundancy (e.g., the attribution table is verbose, the Critic Agent section repeats a template pattern twice, and some constraints are restated across sections). The Jira MCP tool listing is useful reference but could be more compact.

2 / 3

Actionability

The skill provides highly concrete, executable guidance: specific MCP tool names, exact branch naming conventions, precise PR title format, specific git commands, exact argument parsing rules, and copy-paste-ready Critic agent prompts. The ticket selection criteria are specific and unambiguous.

3 / 3

Workflow Clarity

The workflow is clearly sequenced with an explicit 8-step per-ticket loop, mandatory PRE-CHECK/POST-CHECK validation via Critic agents for every write action, explicit error recovery (fix and retry until APPROVED), and clear HOLD transitions for blockers. The serial operations verification requirement and feedback loops are well-defined.

3 / 3

Progressive Disclosure

The skill provides a clear overview with a well-organized supporting documents table pointing to one-level-deep references (ticket-workflow.md, pr-workflow.md, ci-validation.md, troubleshooting.md) with explicit guidance to only load what's relevant. Content is appropriately split between the main skill and supporting docs.

3 / 3

Total

11

/

12

Passed

Description

32%

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 conveys the high-level workflow (Jira tickets → PRs → merge) but lacks specificity in concrete actions and completely omits explicit trigger guidance for when Claude should select this skill. It would benefit from listing specific capabilities and adding a 'Use when...' clause with natural trigger terms.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when the user asks to work on Jira tickets, process backlog items, or autonomously create pull requests from issues.'

Include more natural trigger terms users might say, such as 'issues', 'pull requests', 'sprint items', 'stories', 'tasks', or 'JIRA'.

List more specific concrete actions, e.g., 'reads Jira ticket details, creates feature branches, implements code changes, opens pull requests, responds to review comments, and updates ticket status.'

DimensionReasoningScore

Specificity

Names the domain (Jira backlog tickets) and some actions (creating PRs, shepherding to merge), but lacks detail on specific sub-actions like branch creation, code changes, review handling, or ticket status updates.

2 / 3

Completeness

Describes what the skill does but has no explicit 'Use when...' clause or equivalent trigger guidance, and per the rubric guidelines, a missing 'Use when' clause caps completeness at 2. However, the 'when' is so absent that it scores a 1 — there's no indication of when Claude should select this skill.

1 / 3

Trigger Term Quality

Includes relevant terms like 'Jira', 'backlog tickets', and 'PRs', but misses common variations users might say such as 'issues', 'pull requests', 'sprint', 'stories', 'tasks', or 'merge requests'.

2 / 3

Distinctiveness Conflict Risk

The combination of Jira + PR creation is somewhat distinctive, but 'creating PRs' could overlap with general git/PR skills, and 'backlog tickets' is broad enough to potentially conflict with other project management or ticket-handling skills.

2 / 3

Total

7

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
DataDog/datadog-agent
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.