/audit

Audit the knowledge base for quality issues: missing frontmatter, broken links, tag inconsistencies, orphaned files, and coverage gaps. Works on any markdown-heavy project.

Steps

Parse focus area from
```
$ARGUMENTS
```
(optional). If provided, focus on that area (e.g., "tags", "frontmatter", "links"). If empty, run full audit.
Find all markdown files: Use Glob to find all .md files, excluding common non-content directories:
```
.venv/
```
,
```
node_modules/
```
,
```
.git/
```
,
```
.embeddings/
```
,
```
archive/
```
,
```
.archive_old/
```
.
Frontmatter audit: For each markdown file, read it and check:
- Has YAML frontmatter (starts with
```
---
```
  and has closing
```
---
```
  )
- Required fields present:
```
type
```
  ,
```
status
```
  ,
```
title
```
  ,
```
tags
```
- ```
type
```
  is valid: one of
```
principle
```
  ,
```
methodology
```
  ,
```
agent
```
  ,
```
opportunity
```
  ,
```
capture
```
  ,
```
research
```
- ```
status
```
  is valid: one of
```
active
```
  ,
```
draft
```
  ,
```
validated
```
  ,
```
archived
```
- ```
tags
```
  is a non-empty list Track files missing frontmatter and files with incomplete/invalid frontmatter.
Link check: Look for broken internal links:
- If
```
scripts/check_links.py
```
  exists, run it:
```
uv run python scripts/check_links.py
```
- Otherwise: Grep for markdown links
```
\[.*\]$.*\.md$
```
  and verify each target exists
Tag consistency audit: Use Grep to find all
```
tags:
```
sections across .md files. Look for:
- Near-duplicate tags (e.g., "ai" vs "AI" vs "artificial-intelligence")
- Tags used only once (potential typos)
- Very common tags that might be too broad List all unique tags with counts.
Orphaned files: Check which files are NOT referenced in any other file's
```
related:
```
field. Files that exist but are never cross-referenced may be orphaned.
Opportunity quality: Find all documents with
```
type: opportunity
```
and check:
- Missing
```
opportunity_score
```
  field
- ```
evidence_sources
```
  = 0 or missing
- Status still
```
draft
```
  for more than 30 days
Coverage gaps: Check each directory for content:
- Flag any empty or near-empty directories
- Look for directories with only 1-2 files (may need more content)

Output report:

## KB Audit Report

**Date:** [today]

### Summary
- Total .md files: X
- With frontmatter: X (X%)
- Without frontmatter: X

### Frontmatter Issues
| File | Issue |
|------|-------|
| path | Missing field: type |

### Broken Links
[list of broken references]

### Tag Analysis
- Total unique tags: X
- Single-use tags: [list]
- Potential duplicates: [list]

### Orphaned Files
[files not referenced anywhere]

### Opportunity Quality
- Without opportunity_score: [list]
- Without evidence_sources: [list]

### Coverage
[directory analysis]

### Recommendations
1. [specific action]
2. [specific action]
3. [specific action]

solo-audit

NPX Install

Tags

SKILL.md Content

/audit

Steps