skills.rest
olivermorgan2
olivermorgan2COMMUNITY
Explore all skills by this author →
WebsiteGitHub

audit-milestone

Audits GitHub milestones for issue closure, ADR-to-PR linkage, and phase exit criteria.

Updated Apr 12, 2026
Search Tags:#workflow#github#adr#audit#compliance#milestone
One-click install
npx skills add https://github.com/olivermorgan2/workflow-generator --skill audit-milestone-olivermorgan2
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-milestone
Source: https://github.com/olivermorgan2/workflow-generator/tree/main/skills/audit-milestone
Command: npx skills add https://github.com/olivermorgan2/workflow-generator --skill audit-milestone-olivermorgan2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the uncertainty of closing a project milestone by automatically verifying that all issues are resolved, ADRs are properly linked to merged PRs, and phase exit criteria are met.

Core Features & Use Cases

  • Automated Integrity Checks: Validates that every issue in a milestone is closed and that all referenced ADRs have corresponding implementation PRs.
  • Phase Compliance: Automatically checks status rows in build-out-plan.md to ensure phase exit criteria are satisfied.
  • Use Case: Before closing a major release milestone, run this skill to generate a comprehensive gap report, ensuring no documentation or implementation tasks were left unfinished.

Quick Start

Run the audit-milestone skill for the milestone titled v-next to verify all completion requirements are met.

Frequently Asked Questions about audit-milestone

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

FAQPage Schema
How do I verify GitHub milestone completion criteria before closing a release?▼

Verify GitHub milestone completion by auditing issue closure, ADR-to-PR linkage, and phase exit criteria. This process generates a gap report to ensure no documentation or implementation tasks remain unfinished before closing.

How do I check if ADRs are linked to merged pull requests in my repository?▼

Check if ADRs are linked to merged pull requests by running an automated integrity audit on the project repository. This validates that every referenced architecture decision record has a corresponding implementation PR.

How do I validate phase exit criteria from a build-out-plan markdown file?▼

Validate phase exit criteria by automatically checking status rows in the build-out-plan.md file. This ensures that defined delivery workflows and documentation standards are satisfied for the project milestone.

Do I need GitHub CLI access to audit repository milestone readiness?▼

Yes, you need authenticated GitHub CLI access to audit repository milestone readiness. The audit queries milestone data and pull request history using this access without modifying the repository state.

Can I run a compliance audit on a milestone without modifying my repository state?▼

Yes, you can run a compliance audit without modifying your repository state. The verification process queries milestone data and pull request history in read-only mode to ensure delivery workflow adherence.

What is the best way to generate a gap report for unfinished milestone tasks?▼

The best way to generate a gap report for unfinished tasks is to run a comprehensive milestone audit. This identifies unresolved issues and missing documentation links before closing a major release milestone.

Related Skills

Explore More Software Engineering Skills→
faccomichelefaccomichele

github-read-access

Inspect GitHub repository data, issues, pull requests, releases, and CI runs via gh CLI.

Community
Intermediate
whatwecandowhatwecando

forge-ship

Close and archive a current milestone with report, git tag, and cleanup.

Community
Advanced
youhei-ushioyouhei-ushio
1

issue

Automate GitHub issue workflows from code fetching to pull request creation.

Community
Advanced
giovannimnzgiovannimnz

gsd-verify-work

Evaluate phase acceptance criteria and definition of done to output READY or NEEDS_WORK status.

Community
Intermediate