CtrlK
BlogDocsLog inGet started
Tessl Logo

jira-transitions

Move Jira issues through workflow states. Use when transitioning issues (To Do, In Progress, Done) or setting resolutions.

65

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable TypeScript and curl examples and a well-sequenced implementation pattern, but it loses points on conciseness from TS/curl duplication and on progressive disclosure because everything lives in one large file with no reference bundles. Workflow clarity is solid but capped by the absence of a recovery feedback loop for the batch transition operation.

Suggestions

Remove the TS/curl duplication by keeping one canonical representation and noting the other form briefly, or move the curl examples into a references file.

Add a validate/fix/retry feedback loop to bulkTransition (e.g. log the failing issue's available transitions and optionally retry) so the batch operation has an explicit recovery checkpoint.

Split the detailed type definitions, curl examples, and reference tables into references/ files and link to them from a leaner SKILL.md overview to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The body is mostly lean code without explanatory fluff, but it duplicates the same operations in both TypeScript and curl (e.g. the simple transition, transition-with-resolution, and transition-with-comment examples), so it could be tightened; it is above level 1 because it does not explain concepts Claude already knows and every section is actionable.

2 / 3

Actionability

The skill provides fully executable TypeScript functions and copy-paste-ready curl commands with concrete IDs, field shapes, and response examples; it is above level 2 because the code is complete and runnable rather than pseudocode or abstract direction.

3 / 3

Workflow Clarity

Steps 1-6 are clearly sequenced and include an explicit "Always query available transitions first" checkpoint plus null-transition handling, but the bulk-transition batch operation only records failures without a validate/fix/retry feedback loop, so per the batch-operation guideline workflow clarity is capped at 2; it is above level 1 because the sequence and some checkpoints are present.

2 / 3

Progressive Disclosure

No bundle files exist and the single SKILL.md is ~340 lines with clear sections, but content that could be split out (curl examples, full type definitions, the common-transitions/resolution tables) is inline with only one external URL reference; it is above level 1 because organization is clear rather than a monolithic wall, but below level 3 because no one-level-deep reference files are used to offload detail.

2 / 3

Total

9

/

12

Passed

Description

90%

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 is concise, third-person, and clearly answers both what the skill does and when to use it, with strong natural trigger terms and low conflict risk. Its only weakness is specificity, as it summarizes the capability in one action rather than enumerating the multiple concrete operations the skill supports.

Suggestions

Enumerate the concrete actions in the description, e.g. "Query available transitions, execute status changes, bulk-transition issues, and set resolutions when closing issues."

DimensionReasoningScore

Specificity

The phrase "Move Jira issues through workflow states" names the domain and a primary action but does not enumerate multiple distinct concrete actions (e.g. querying transitions, executing transitions, bulk-moving, setting resolution) the way a level-3 anchor does; it is not level 1 because it is concrete rather than vague.

2 / 3

Completeness

It explicitly states both what it does ("Move Jira issues through workflow states") and when to use it ("Use when transitioning issues ... or setting resolutions"), matching the level-3 anchor with an explicit "Use when" clause; it is above level 2 because the when is explicit, not implied.

3 / 3

Trigger Term Quality

"Use when transitioning issues (To Do, In Progress, Done) or setting resolutions" gives good coverage of natural terms a user would say, including the concrete status names and the resolution concept; it is above level 2 because it includes common variations rather than a single keyword.

3 / 3

Distinctiveness Conflict Risk

The Jira-transitions niche is specific with distinct triggers (To Do/In Progress/Done, resolutions) unlikely to conflict with other skills; it is above level 2 because the scope is narrowly scoped to Jira workflow transitions rather than overlapping generic issue-handling skills.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
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.