Reviewing Notes for Quality

This skill audits the knowledge base for quality issues and produces an actionable report.

Workflow

1. Scan All Content

# List all content files
ls content/*.md

2. Check Each Note For Issues

Read each file and check for:

Missing or Weak Summaries

• •No summary: field in frontmatter
• •Summary is empty or very short (<10 words)
• •Summary doesn't capture the core idea

Broken Wiki-Links

Parse all [[slug]] patterns and verify each target exists:

# Extract wiki-links from a file
grep -o '\[\[[^]]*\]\]' content/note-name.md

# Check if target file exists
ls content/target-slug.md

Insufficient Tags

• •Notes with fewer than 2 tags
• •Notes with no tags at all

Orphan Notes

• •No outgoing wiki-links (doesn't reference other notes)
• •No incoming wiki-links (not referenced by other notes)
• •Both = fully isolated

Short Content

• •Body content under 100 words (may indicate incomplete note)

Missing Required Frontmatter

• •No title field
• •No type field
• •Missing date field

3. Generate Report

Organize findings by severity:

## Quality Audit Report

### Critical Issues
- **Broken Links**
  - `note-a.md`: links to [[non-existent]] (file not found)

### High Priority
- **Missing Summaries**
  - `note-b.md`: no summary field
  - `note-c.md`: summary is empty

- **Orphan Notes** (no connections)
  - `isolated-note.md`: 0 incoming, 0 outgoing links

### Medium Priority
- **Insufficient Tags** (<2 tags)
  - `note-d.md`: only 1 tag

- **Short Content** (<100 words)
  - `stub-note.md`: 45 words

### Low Priority
- **Missing Optional Fields**
  - `note-e.md`: no date field

Issue Categories

Quality Checklist

When reviewing:

• • Checked all content files
• • Verified each wiki-link target exists
• • Counted tags per note
• • Identified orphan notes
• • Measured content length
• • Prioritized issues by severity