Agent skill
vault-gaps
Find knowledge gaps (topics mentioned but not documented). Triggers on "knowledge gaps", "content gaps", "missing notes", "gaps".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/documents/find-gaps
SKILL.md
Knowledge Gaps
Find topics that are mentioned but not properly documented.
Purpose
Knowledge gaps are:
- Topics mentioned in multiple notes
- But have no dedicated note
- OR broken wikilinks (mentioned but file doesn't exist)
- OR unlinked mentions (not yet formalized)
These represent opportunities to create new content.
Types of Gaps
1. Broken Links - Explicitly linked but file missing
[[Feature Not Built Yet]] → No file exists
2. Unlinked Mentions - Mentioned but not linked
"We should implement authentication" → Not wikilinked
3. Stub Pages - Note exists but empty/minimal content
# Authentication
(2 lines, no substance)
Process
1. Find Broken Links
broken = find_broken_links()
→ Group by frequency (how many notes reference this missing topic)
2. Find Unlinked Mentions
// Check for common unlinked topics
topics = ["authentication", "api", "deployment", "testing", ...]
unlinked = []
for topic in topics:
mentions = get_unlinked_mentions(topic)
if mentions.count > 3:
unlinked.append(topic)
3. Find Stub Pages
all_notes = search_notes({})
stubs = []
for note in all_notes:
backlinks = get_backlinks(note)
if backlinks.count > 5 and note.word_count < 100:
stubs.append(note)
4. Report Results
Knowledge Gaps
═══════════════════════════════════════════════
Found 34 knowledge gaps
🚨 High Priority Broken Links (10+ references):
• [[API Authentication]] - Referenced 24 times, no file
• [[Deployment Guide]] - Referenced 18 times, no file
• [[Testing Strategy]] - Referenced 12 times, no file
⚠️ Frequently Unlinked Topics (5+ mentions):
• "authentication" - 15 unlinked mentions
• "deployment" - 12 unlinked mentions
• "api design" - 8 unlinked mentions
📝 Stub Pages (high backlinks, low content):
• [[Best Practices]] - 34 backlinks, 45 words
• [[Team Process]] - 28 backlinks, 67 words
💡 Actions:
• Create notes for high priority broken links
• Formalize frequently mentioned topics
• Expand stub pages with proper content
═══════════════════════════════════════════════
Recommended Actions
For each gap:
- Create note: Make the missing file
- Add content: Write documentation
- Link existing: Use unlinked-mentions skill to find and link
- Expand stubs: Add substance to minimal notes
Version: 1.0.0
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?