auditlisted
Install: claude install-skill aksheyw/claude-code-learned-skills
# Codebase Audit — 10-Category Systemic Bug Finder
This skill codifies hard-won lessons from production bugs. Every pattern here was discovered the hard way — usually one instance revealing many more across the codebase. Use it proactively, not reactively.
## How to Use This Skill
Pick the relevant audit category (or run all 10 for a pre-deploy check). Each category has:
- **Why it matters** — the real-world consequence
- **Detection** — how to find instances
- **The ripple search** — how one bug leads to more
- **Fix pattern** — the proven solution
- **Checklist** — verify completeness
---
## 1. Display Value Formatting
**The bug:** Database/API values stored as machine-readable keys (`bright_indirect`, `cactus_mix`, `glazed_ceramic`) leak into the UI without formatting.
**Why it's systemic:** The same field renders in multiple views (detail pages, cards, lists, settings). If one field leaks raw values, sibling fields almost certainly do too. In the original case, one `bright_indirect` bug turned into 9 fixes across 7 files.
### Detection
Scan for template expressions that render data fields without a formatting function:
```
# Red flags in rendered output:
{plant?.fieldName} # React/JSX — raw field in display context
{{ item.field_name }} # Vue/Angular/Handlebars
${data.fieldName} # Template literals
```
**Visual red flags:**
- Underscores in user-facing text (`bright_indirect`, `cactus_mix`)
- camelCase in user-facing text (`needsAtte