Schema Gaps Finder

Find notes that are missing expected fields based on what other notes in the same folder have.

When to Use

Invoke when you want to:

• Find notes with incomplete metadata
• Identify gaps in your note consistency
• Get suggestions for what fields to add
• See completeness scores for your notes

Arguments

Process

1. Parse User Input

Recognize gap-finding requests:

• "find notes with missing fields"
• "which notes are incomplete?"
• "show me schema gaps in meetings/"

2. Call MCP Tool

mcp__flywheel__find_incomplete_notes({
  folder: "meetings/",
  min_frequency: 0.7,
  limit: 50
})

3. Format Results

## Incomplete Notes Report

### meetings/ (3 incomplete of 47)

#### meetings/2025-12-20 Client Call.md
**Completeness:** 50%

Missing fields:
| Field | Expected Type | Frequency | Suggested Value |
|-------|---------------|-----------|-----------------|
| attendees | array | 87% | (detect from prose) |
| tags | array | 91% | ["meeting"] |

#### meetings/2025-12-22 Quick Sync.md
**Completeness:** 67%

Missing fields:
| Field | Expected Type | Frequency | Suggested Value |
|-------|---------------|-----------|-----------------|
| tags | array | 91% | ["meeting", "standup"] |

---

**Summary:**
- 3 notes need attention
- Most common missing field: `tags` (3 notes)
- Run `/schema-apply` to add suggested fields

Use Cases

• Quality audit: "How consistent is my metadata?"
• Batch fixing: "What notes need fields added?"
• Pre-migration: "Find gaps before changing schema"
• Review workflow: "Check notes before archiving"

Integration

Works well with other skills:

• schema-infer: Understand what fields are expected
• schema-apply: Apply suggested fixes
• vault-search: Find specific incomplete notes

Version: 1.0.0