# Workspace Audit

> Audit all git repos under ~/dev for dirty state, unpushed commits, exposed .env files, and tracked context files (CLAUDE.md, AGENTS.md, GEMINI.md). Use when the user wants to know if their workspace is clean, before a deploy, or when something feels off. Triggers on "audit workspace", "check repos", "anything unpushed", "is my workspace clean", "check for dirty repos", "any exposed secrets".

- Skill: `aibot88/workspace-audit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aibot88/workspace-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/workspace-audit/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: aibot88 (https://skillmd.com/u/aibot88)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aibot88/workspace-audit

---


# Workspace Audit

Scans all git repos under `~/dev` for issues that need attention. The script handles all detection — your job is to synthesize the output and tell the user what needs action.

## Step 1 — Collect

```bash
~/.claude/commands/workspace-audit/scripts/audit.sh
```

## Step 2 — Synthesize

Read the labeled sections and produce a concise report:

### Git Repos
List every `NEEDS ATTENTION` entry with its flags. Group by type:
- **DIRTY** — uncommitted changes
- **UNTRACKED** — files not in git
- **NO-REMOTE** — no origin configured
- **AHEAD:N** — commits not pushed

Clean repos don't need a mention unless the user asks.

### Security Checks
Report any `EXPOSED:` .env files or `TRACKED:` context files immediately — these are high-priority.

### Disk Usage
Report `~/dev/` total size.

### Summary
- N repos clean, N repos need attention
- If `STATUS: CLEAN` → tell the user everything looks good
- If `STATUS: NEEDS ATTENTION` → list the top actions in priority order

Keep it tight. Flag security issues first, then unpushed work, then cosmetic.