Skill530 repo starsupdated 1mo ago

repo-auditor

Repo Auditor scans code changes before committing or opening pull requests to identify stale comments, unused imports, missing test coverage, and style inconsistencies. Use it after editing code, resolving merge conflicts, or when verifying PR readiness by comparing changes against a base branch and checking against an audit checklist for documentation updates and public function test coverage.

View source Repository: LLM-Agents-Ecosystem-Handbook

Install in Claude Code

Copy

git clone --depth 1 https://github.com/oxbshw/LLM-Agents-Ecosystem-Handbook /tmp/repo-auditor && cp -r /tmp/repo-auditor/skills/examples/repo-auditor ~/.claude/skills/repo-auditor

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Repo Auditor

## When to use
- After making code edits, before `git commit` or PR open
- After resolving merge conflicts
- When the user asks "is this PR ready?"

## When NOT to use
- During exploration / read-only work
- For purely formatting changes (lint/format already covers it)

## Inputs
| Name | Type | Required | Notes |
|---|---|---|---|
| `base` | string | no | base ref (default `origin/main`) |
| `paths` | list | no | restrict to specific paths |

## Workflow
1. **Diff**: `git diff <base>...HEAD --name-only` and `git diff <base>...HEAD`
2. **For each changed file**: load `references/audit-checklist.md` and walk it
3. **Check tests**: any new public function without a corresponding test → flag
4. **Check imports**: unused imports / missing imports → flag
5. **Check style fit**: does the new code match neighboring code's idioms?
6. **Check docs**: did this change require an `AGENTS.md` / `MEMORY.md` / README update? → flag if missed
7. **Produce report**: structured output (see Outputs)

## References
- [`references/audit-checklist.md`](references/audit-checklist.md)

## Outputs
```markdown
## Audit report
- ✅ {{N}} files reviewed
- 🟡 {{N}} warnings
- 🔴 {{N}} blockers

### Blockers
- {{file:line}} — {{issue}}

### Warnings
- {{file:line}} — {{issue}}
```

## Success criteria
- 0 blockers (PR can open) OR
- All blockers explicitly acknowledged by user

## Failure modes
- Diff too large (> 1k lines) → ask user to scope
- Cannot read base ref → fail with instructions