jira-hygiene

Validate and fix Jira issue fields and transition ready issues to refinement.

2|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/dmzoneill/skills --skill jira-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-hygiene
Source: https://github.com/dmzoneill/skills/tree/main/jira-hygiene
Command: npx skills add https://github.com/dmzoneill/skills --skill jira-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the common issue of incomplete or poorly formatted Jira tickets, ensuring all necessary details are present before development or refinement begins.

Core Features & Use Cases

  • Automated Validation: Checks descriptions, acceptance criteria, priority, labels, epic links, and story points against defined standards.
  • Automated Fixing: Can automatically set priority, link epics, and assign story points based on provided inputs or defaults.
  • Status Transition: Automatically moves 'New' issues to 'Refinement' if all criteria are met.
  • Use Case: When a new story is created, use this skill to automatically check if it has a description, acceptance criteria, and is linked to an epic, then transition it to 'Refinement' if ready.

Quick Start

Use the jira-hygiene skill to check and fix issue AAP-12345.

Frequently Asked Questions about jira-hygiene

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically validate Jira issue quality and completeness before refinement?

You can automatically validate Jira issue quality by checking descriptions, acceptance criteria, priority, labels, epic links, and story points against defined hygiene standards. This ensures all necessary ticket details are present before development begins.

How do I enforce missing fields like priority and story points on Jira tickets?

You can enforce missing fields on Jira tickets by automatically setting priority, linking epics, and assigning story points based on provided inputs or defaults. This automated fixing ensures issues meet completeness standards without manual intervention.

Can I automatically transition new Jira issues to refinement when all criteria are met?

Yes, you can automatically transition new Jira issues to refinement when all criteria are met. The validation process checks that required fields like acceptance criteria and epic links are complete before moving the issue status.

What Jira issue fields are required to pass automated hygiene validation?

Required Jira issue fields for automated hygiene validation include descriptions, acceptance criteria, priority, labels, epic links, and story points. All fields must be complete to satisfy the defined standards and allow status transitions.

What's the best way to check and fix incomplete Jira stories created by other team members?

The best way to check and fix incomplete Jira stories is to validate them against hygiene standards for descriptions, acceptance criteria, and epic links, then automatically apply default values for missing fields like priority and story points.

Does this automated issue tracking validation work with the Jira API for issue inspection?

Yes, this automated issue tracking validation integrates directly with the Jira API for issue inspection and modification. It can read existing ticket fields and update missing values to enforce hygiene standards.