# system-audit

Audits multi-agent workspaces for configuration drift, test mismatches, and documentation gaps. Generates a prioritized findings brief without applying automated changes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 637 installs · ★ 3
- Author: gasserane
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gasserane/personal-skills/tree/HEAD/skills/system-audit/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/gasserane-system-audit

## What it does

The skill inspects multi-agent workspace layers for silent drift. It executes `tests/run_tests.py` and matches the results against recent `weekly-health-check-*.md` logs. Empty directories can cause false passes. To prevent missed failures, the audit diffs check names directly and simulates remote test execution.

The audit examines documentation consistency and agent definitions. Paths are resolved dynamically. The skill queries the test module directly to locate active skills directories, comparing them against the repository clone. On Windows, diff runs with `--strip-trailing-cr` to suppress newline mismatches. It also flags `SKILL_BUDGETS` line overruns and overlay files exceeding 35 KB.

The skill does not apply fixes to code or configuration files. It writes a structured action brief listing file locations, line numbers, and suggested fix sequences. You need the underlying Python test harness already configured in your repository. Every change requires manual review.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill system-audit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/system-audit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/system-audit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill system-audit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/system-audit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill system-audit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/system-audit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gasserane/personal-skills system-audit
```

2. **Manually: put the files in place**
- File: `.github/skills/system-audit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill system-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gasserane/personal-skills --path skills/system-audit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/system-audit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill system-audit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gasserane/personal-skills/tree/HEAD/skills/system-audit/SKILL.md

## When to use it
- detect discrepancies between local test runs and cloud routine reports
- catch agent skill files approaching line count limits in SKILL_BUDGETS
- identify count mismatches across CLAUDE.md files and agent registries
- flag agent overlay files exceeding the 35 KB size limit

## Example prompts
- /system-audit
- Check workspace health and agent consistency with /audit
- Run a system check before starting /li curate

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

## Other versions with the same name
- [system-audit · awrshift](https://affpapa.org/en/nevibecode/skills/system-audit.md) — ★ 34

From the same set: [gasserane/personal-skills](https://affpapa.org/en/nevibecode/by/gasserane/personal-skills.md) — 29 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md