audit-issues

Audit GitHub Projects issues for duplicates, missing fields, and unlinked tasks.

Updated Dec 11, 2025
One-click install
npx skills add https://github.com/semicolon-devteam/semo --skill audit-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-issues
Source: https://github.com/semicolon-devteam/semo/tree/main/packages/pm/skills/audit-issues
Command: npx skills add https://github.com/semicolon-devteam/semo --skill audit-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Bash, gh, jq, and includes references (resource) components.

What problem does it solve?

This Skill automatically audits all issues within your GitHub Projects board, identifying common quality problems like duplicates, missing essential fields, unlinked issues, and unestimated tasks, which can hinder effective project management.

Core Features & Use Cases

  • Duplicate Issue Detection: Identifies issues with similar titles or content, suggesting potential duplicates.
  • Required Field Validation: Flags issues missing critical fields like 'Type' or 'Priority'.
  • Projects Linkage Check: Finds issues across repositories that are not correctly linked to the '이슈관리' Projects board.
  • Workload Estimation Audit: Highlights 'Task' type issues that lack an assigned workload (estimate points).
  • Use Case: Before a Sprint planning session, you can run "이슈관리 보드 전체 이슈 품질 감사" to clean up your backlog, ensuring all tasks are well-defined and ready for estimation.

Quick Start

Audit all issues: "이슈관리 보드의 전체 이슈 품질 감사" Check for missing fields: "필수 필드 누락 검토" Find unestimated tasks: "task 이슈 작업량 미할당 검토"

Frequently Asked Questions about audit-issues

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

FAQPage Schema
How do I audit GitHub Projects for duplicate issues and missing fields?

Audit GitHub Projects by running the audit-issues Skill to automatically detect duplicate issues, flag missing mandatory fields like Type or Priority, and identify unlinked issues across repositories. The Skill generates a normalized markdown report suitable for SEMO pipelines.

What quality checks does a GitHub issue audit cover?

Issue audits cover four functional checks: duplicate detection by title and content similarity, validation of required fields, verification that issues are correctly linked to the Projects board, and workload estimation checks for Task-type issues lacking assigned estimate points.

Can I use this to clean up my backlog before sprint planning?

Yes. Run the audit before sprint planning to identify and resolve quality problems—duplicates, missing fields, unlinked issues, and unestimated tasks—ensuring your backlog is well-defined and ready for estimation.

What dependencies and tools does the audit-issues Skill require?

The Skill requires Bash, the GitHub CLI (gh), and jq for command-line JSON processing. These tools enable querying GitHub Projects data, filtering issues, and generating the audit report.

How does the Skill handle issues across multiple repositories?

Audit-issues applies to semicolon-devteam Projects boards across multiple repositories, checking that all issues are correctly linked to the designated Projects board and validating consistency of fields and estimates organization-wide.

What output format does the audit generate?

The Skill generates a normalized markdown report designed for SEMO pipelines, making it suitable for downstream processing, integration into CI/CD workflows, or conversion to other formats for stakeholder review.