workspace-audit

Audit all git repos in a workspace and generate structured reports.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dlepaux/dotfiles --skill workspace-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-audit
Source: https://github.com/dlepaux/dotfiles/tree/main/.claude/skills/workspace-audit
Command: npx skills add https://github.com/dlepaux/dotfiles --skill workspace-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the comprehensive quality audit of all git repos within a workspace, surfacing findings and delivering structured artifacts that drive iterative fix sessions.

Core Features & Use Cases

  • Discover repos by scanning for git folders across the workspace and determining the tech stack per repo.
  • Run parallel data collection with agents to surface constants, typing, tests, and dependencies across repos.
  • Produce a workspace-wide plan and per-audit artifacts (plan/audit-NN with index.md and flat 01-*.md stories).
  • Update root plan/index.md to include the new audit and support dry-run mode for non-destructive analysis.
  • Provide a consolidated executive summary and cross-repo patterns to guide prioritization.
  • Structure findings as actionable stories ready for follow-up fix sessions.

Quick Start

Run a workspace quality audit to scan all git repos, generate plan/index.md and audit artifacts, and prepare stories for follow-up fixes.

Frequently Asked Questions about workspace-audit

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

FAQPage Schema
How do I run a quality audit across all git repositories in my workspace?

Run a workspace quality audit to scan all git repos, detect tech stacks, aggregate findings, and generate prioritized action plans with structured stories under plan/audit-NN. The process discovers repositories and produces a workspace-wide report.

What is a workspace audit for software engineering repositories?

A workspace audit is a methodical quality scan across all git repos that surfaces constants, typing, tests, and dependencies. It aggregates findings into a consolidated executive summary and cross-repo patterns to guide prioritization.

Can I perform a read-only workspace audit without modifying my repositories?

Yes, the workspace audit supports a dry-run mode for non-destructive analysis and maintains read-only access during the audit phase. It only updates the root plan/index.md and creates audit artifacts after completion.

How do I generate actionable stories from repository audit findings?

The audit produces per-audit artifacts with flat 01-*.md story files under plan/audit-NN directories. These structured stories are ready for follow-up fix sessions and are accompanied by an index.md for navigation.

Does the workspace audit support parallel data collection across repositories?

Yes, the audit runs parallel data collection with agents to surface constants, typing, tests, and dependencies across all discovered repos. This aggregates findings efficiently into a workspace-wide executive summary.

What's the best way to prioritize code quality fixes across multiple repositories?

Use the workspace audit to generate a consolidated executive summary with cross-repo patterns that guide prioritization. The audit produces structured artifacts and a prioritized action plan to drive iterative fix sessions.