audit-repos

Audit a GitHub user's repositories through an eight-phase PowerShell pipeline.

2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/nholder88/ai-agent-workflows --skill audit-repos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-repos
Source: https://github.com/nholder88/ai-agent-workflows/tree/main/cowork-plugins/repo-audit/skills/audit-repos
Command: npx skills add https://github.com/nholder88/ai-agent-workflows --skill audit-repos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Run end-to-end audit across a user's GitHub repos to inventory, analyze, and consolidate, including drafting READMEs and preparing PRs for consolidation or archiving.

Core Features & Use Cases

  • Inventory repositories to build a full inventory and surface metadata for analysis.
  • Analyze each repository for problem/goal/state/completion to guide consolidation decisions.
  • Detect duplicates and generate a ConsolidationPlan with recommended actions.
  • Draft READMEs for kept repos and emit PowerShell scripts to stage drafts and archival actions.
  • Produce an audit trail via _inventory, _analysis, and _drafts for review and rollback.

Quick Start

Run the audit against a target GitHub user and review the generated inventory, analysis, and draft PRs.

Frequently Asked Questions about audit-repos

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

FAQPage Schema
How do I audit and consolidate a sprawling collection of GitHub repositories?

To audit GitHub repositories, an eight-phase pipeline inventories repo contents, analyzes project status, detects duplicates, and drafts READMEs. It stores outputs in _inventory, _analysis, and _drafts directories to guide consolidation and archival decisions.

Can I generate READMEs and prepare consolidation PRs for multiple repos automatically?

Yes, you can automatically generate READMEs and prepare consolidation PRs. The skill drafts READMEs for kept repositories and emits PowerShell scripts to stage pull requests for consolidation or archival actions.

What do I need to run a local GitHub repo analysis and triage?

Running local GitHub repo analysis requires the gh and git command-line dependencies, along with user-provided credentials. The skill executes its eight-phase pipeline locally, storing outputs in _inventory, _analysis, and _drafts directories.

How does repo duplicate detection work when triaging GitHub accounts?

Duplicate detection works by analyzing each repository's problem, goal, state, and completion status. The skill generates a ConsolidationPlan with recommended actions to merge, archive, or keep duplicate repositories.

What is the best way to inventory and analyze personal GitHub repos for cleanup?

The best way to inventory personal GitHub repos is running an end-to-end audit that surfaces metadata for analysis. The skill builds a full inventory, evaluates each repo's completion state, and produces an audit trail for review and rollback.