// Audit the maintained wiki for quality and maintenance issues. Use when asked to "review notes", "check content quality", "audit my knowledge base", or "find broken links".
| name | reviewing-notes |
| description | Audit the maintained wiki for quality and maintenance issues. Use when asked to "review notes", "check content quality", "audit my knowledge base", or "find broken links". |
| allowed-tools | Read, Glob, Grep |
This skill audits the knowledge base for quality issues and maintenance debt, not just markdown hygiene.
# List all content files
ls src/content/notes/notes/*.md
Read each file and check for:
summary: field in frontmatterParse all [[slug]] patterns and verify each target exists:
# Extract wiki-links from a file
grep -o '\[\[[^]]*\]\]' src/content/notes/notes/note-name.md
# Check if target file exists
ls src/content/notes/notes/target-slug.md
title fieldtype fielddate fieldOrganize 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 | Severity | Impact |
|---|---|---|
| Broken wiki-link | Critical | Navigation fails |
| Missing summary | High | Poor discoverability |
| Orphan note | High | Lost in graph |
| <2 tags | Medium | Harder to find |
| Short content | Medium | May be incomplete |
| Missing date | Low | Timeline unclear |
When reviewing:
Ingest a new source into the LLM Wiki. Save the full captured resource under src/content/notes/sources/ first, then create or update the maintained wiki summary/synthesis entry, index, and log. Trigger on "add", "save", "capture", "note this", "take notes on", or any request to record content in the knowledge base.
Query the maintained wiki layer first, then fall back to sources when needed. Use when asked to "ask my notes", "what do I know about", "query my knowledge", "/ask", or when the user has a question that the wiki might answer.
Summarize the past week's daily journal entries. Use when asked to "weekly review", "review the week", "summarize this week", or "week summary".
Curate wiki maps and clustering pages for the LLM Wiki. Use when asked to "curate MOCs", "update maps", "find clusters", "what MOCs need updating", or "organize my notes".
Generate a weekly newsletter summarizing resources added last week. Use when asked to "weekly newsletter", "newsletter", "what did I add this week", "generate newsletter", or "Monday newsletter".
Add tweets to the Second Brain. Use when the user provides a Twitter/X URL and pasted tweet content, asking to "add a tweet", "save this tweet", or "capture this tweet".