Craft comprehensive JIRA tickets (summary, context, requirements, deliverables, definition of done) from a title plus repo/user inputs. Trigger when the user asks for help drafting or refining a JIRA card, ticket, or story and expects structured markdown saved to disk.
70
85%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
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 strong skill description that clearly communicates what the skill does (crafts structured JIRA tickets with enumerated sections), what inputs it needs (title plus repo/user inputs), and when to trigger it (drafting or refining JIRA cards/tickets/stories). It uses third-person voice, includes natural trigger terms covering common variations, and is distinctive enough to avoid conflicts with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and outputs: 'summary, context, requirements, deliverables, definition of done' from 'title plus repo/user inputs'. This clearly describes what the skill produces with enumerated components. | 3 / 3 |
Completeness | Clearly answers both 'what' (craft comprehensive JIRA tickets with specific sections from title/repo inputs) and 'when' (explicit trigger clause: 'Trigger when the user asks for help drafting or refining a JIRA card, ticket, or story and expects structured markdown saved to disk'). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'JIRA', 'ticket', 'card', 'story', 'drafting', 'refining'. These cover common variations of how users refer to JIRA work items. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: JIRA ticket creation with specific structured output saved to disk. The combination of JIRA-specific terminology, structured markdown output, and the save-to-disk detail makes it unlikely to conflict with general writing or project management skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
70%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 skill with clear workflow sequencing and good progressive disclosure through referenced template and checklist files. Its main weakness is the lack of a concrete example showing a completed JIRA card output, which would significantly improve actionability. Some minor verbosity could be trimmed, particularly motivational phrases and partially redundant guidance across sections.
Suggestions
Add a concrete example showing a sample card title input and the resulting JIRA card markdown output (even abbreviated) to demonstrate the expected format and quality level.
Remove motivational/explanatory phrases like 'so every section is grounded in facts instead of guesses' and 'so engineers can trace assertions quickly' — these explain rationale Claude doesn't need.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some unnecessary elaboration. Phrases like 'so every section is grounded in facts instead of guesses' and 'so engineers can trace assertions quickly' are motivational rather than instructional. The Writing Guidance section partially restates what's already in the Card Structure and Workflow sections. However, it avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | The skill provides structured guidance with clear section definitions and a concrete output naming convention, but lacks executable examples. No sample input/output is shown — a concrete example of a completed JIRA card from a sample title would make this significantly more actionable. The instructions are specific enough to follow but remain at the descriptive level rather than demonstrating the exact output format. | 2 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced and logically ordered from clarification through research, definition, enumeration, planning, verification, and dependency capture. The Quality Checklist serves as a validation checkpoint ensuring requirements map to verification steps and assertions cite sources. The workflow includes an explicit clarification step for ambiguous inputs, which acts as a feedback loop. | 3 / 3 |
Progressive Disclosure | The skill cleanly references two supporting files (context_checklist.md and jira_card_template.md) with clear one-level-deep links and descriptions of their purpose. The main SKILL.md serves as an overview with well-signaled navigation to detailed materials. Content is appropriately split between the overview and referenced templates. | 3 / 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.
c0b2e4b
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.