lint-issues

What problem does it solve?

Manually checking GitHub issues for workflow compliance is time-consuming and error-prone, leading to mislabeled issues, incomplete specifications, and broken cross-issue references that disrupt development progress and waste team time.

Core Features & Use Cases

• Label & State Validation: Ensures issues have exactly one correct workflow label, and that label state matches issue content (e.g., has-spec issues have non-empty bodies, in-progress issues have checklists and local branches).
• Spec & Checklist Audits: Verifies issues with has-spec or in-progress labels include all 5 required spec sections, and flags stale in-progress issues, fully checked issues ready for review, or in-progress issues with no completed checklist items.
• Cross-Issue Consistency Checks: Confirms parent issue references and umbrella tasklist links point to valid, correctly statused issues.
• Use Case: Development teams using GitHub Issues for structured workflows can run this audit before sprint planning to catch and fix workflow violations that would otherwise block development.

Quick Start

Ask Claude to run the lint-issues skill to audit all open GitHub issues in your current repository for workflow consistency and receive a grouped report of errors and warnings.