common-doc-audit-k
ALWAYS USE if you are the verifier or gardener. Use after any build cycle to audit documentation accuracy — check diagram drift, living doc freshness, ARCHITECTURE.md currency, cross-link integrity, and plan status. Gardener uses broadly across the full doc tree; verifier uses post-build to confirm the builder did its doc duty.
What this skill does
> **Knowledge skill** — Doc health: what to check, how to prioritize, verifier vs gardener scope.
# Documentation Health
Stale docs actively mislead. From an agent's perspective, anything not in the repo doesn't exist — and anything in the repo that's wrong is worse than nothing.
## Two Scopes
**Verifier** — runs post-build as part of the main loop. Checks: did the builder do its doc duty? Do living docs match what was just built? Are diagrams current? Is ARCHITECTURE.md updated?
**Gardener** — runs anytime, broader scope. Checks: does the entire `design-docs/` tree accurately represent the system? Have things drifted since last audit? Are there orphans, broken links, stale plans?
Same checklist, different aperture.
## What to Check
```
Check │ What "wrong" looks like
─────────────────────────────┼──────────────────────────────────────
Diagram accuracy │ Class diagram missing new fields/methods
│ Data flow doesn't match actual flow
│ Component diagram has removed modules
─────────────────────────────┼──────────────────────────────────────
ARCHITECTURE.md │ Doesn't cover new components
│ Module names don't match code
│ Dependency directions wrong
─────────────────────────────┼──────────────────────────────────────
Living doc freshness │ Describes old behavior
│ References files that don't exist
│ Examples don't work
─────────────────────────────┼──────────────────────────────────────
Plan status │ Completed plans still marked active
│ Progress sections not updated
│ Missing decision logs
─────────────────────────────┼──────────────────────────────────────
Cross-links │ Plans don't link to architecture
│ Living docs not in ARCHITECTURE.md
│ Plans missing from index
─────────────────────────────┼──────────────────────────────────────
Coverage │ Components built without living docs
│ Major modules undocumented
│ New APIs without integration docs
```
## Priority
1. **Actively misleading** — docs that will cause the next agent to make wrong decisions
2. **Drifted** — docs that are stale enough to confuse but not dangerously wrong
3. **Missing** — gaps where docs should exist but don't
4. **Cosmetic** — formatting, naming, minor cross-link fixes
Related in Security
mac-ops
IncludedComprehensive macOS workstation operations — diagnose kernel panics, identify failing drives, audit launchd startup items, decode wake reasons, triage TCC permission denials, manage APFS snapshots, recover from no-boot. Use for: Mac is slow, slow bootup, won't boot, kernel panic, kernel_task hot, mds_stores CPU, photoanalysisd, cloudd, login loop, gray screen, sleep wake failure, drive failing, IO errors, APFS snapshots eating space, Time Machine local snapshots, Spotlight indexing, launchd, LaunchAgent, LaunchDaemon, login items, TCC permissions, Full Disk Access, Screen Recording denied, Gatekeeper, quarantine, com.apple.quarantine, app is damaged, helper tool, /Library/PrivilegedHelperTools, pmset, wake reasons, dark wake, sysdiagnose, panic.ips, DiagnosticReports, configuration profile, MDM profile, remote diagnostics over SSH.
a11y-audit
IncludedRun accessibility audits on web projects combining automated scanning (axe-core, Lighthouse) with WCAG 2.1 AA compliance mapping, manual check guidance, and structured reporting. Output is configurable: markdown report only, markdown plus machine-readable JSON, or markdown plus issue tracker integration. Use this skill whenever the user mentions "accessibility audit", "a11y audit", "WCAG audit", "accessibility check", "compliance scan", or asks to check a web project for accessibility issues. Also trigger when the user wants to verify WCAG conformance or map findings to a specific standard (CAN-ASC-6.2, EN 301 549, ADA/AODA).
erpclaw
IncludedAI-native ERP system with self-extending OS. Full accounting, invoicing, inventory, purchasing, tax, billing, HR, payroll, advanced accounting (ASC 606/842, intercompany, consolidation), and financial reporting. 413 actions across 14 domains, 43 expansion modules. Constitutional guardrails, adversarial audit, schema migration. Double-entry GL, immutable audit trail, US GAAP.
assess
IncludedAssesses and rates quality 0-10 across multiple dimensions (correctness, maintainability, security, performance, testability, simplicity) with pros/cons analysis. Compares against project conventions and prior decisions from memory. Produces structured evaluation reports with actionable improvement suggestions. Use when evaluating code, designs, architectures, or comparing alternative approaches.
spring-boot-security-jwt
IncludedProvides JWT authentication and authorization patterns for Spring Boot 3.5.x covering token generation with JJWT, Bearer/cookie authentication, database/OAuth2 integration, and RBAC/permission-based access control using Spring Security 6.x. Use when implementing authentication or authorization in Spring Boot applications.
code-hardcode-audit
IncludedDetect hardcoded values, magic numbers, and leaked secrets. TRIGGERS - hardcode audit, magic numbers, PLR2004, secret scanning.