Vault Schema

Frontmatter Schema Analyzer

Understand all metadata fields used across your vault.

When to Use

Invoke when you want to:

• Discover what frontmatter fields exist in your vault
• Understand field usage patterns (types, counts)
• Plan metadata standardization
• Get an overview of your vault's schema

Arguments

Process

1. Parse User Input

Recognize schema requests:

• "what frontmatter fields exist in my vault?"
• "show me the vault schema"
• "what metadata fields do I use?"

2. Call MCP Tool

mcp__flywheel__get_frontmatter_schema()

3. Format Results

Frontmatter Schema Analysis
=================================================

Total Fields: 15 unique fields across vault

Field Overview:
-------------------------------------------------

  Field         Type(s)        Usage    Notes
  ──────────────────────────────────────────────
  type          string         234      Most common: "project", "note"
  status        string         156      Most common: "active", "done"
  date          string         342      Date format: YYYY-MM-DD
  tags          array          89       Avg 3 tags per note
  author        string         45       Usually "@username" format
  created       string         412      Timestamp or date
  modified      string         412      Timestamp or date
  aliases       array          67       For note title variations
  priority      number         23       Range: 1-5
  project       string         78       Links to project notes

-------------------------------------------------

Type Distribution:
  string:  10 fields (67%)
  array:   3 fields (20%)
  number:  1 field (7%)
  boolean: 1 field (7%)

Top 5 Most Used Fields:
  1. created (412 notes)
  2. modified (412 notes)
  3. date (342 notes)
  4. type (234 notes)
  5. status (156 notes)

=================================================

Use Cases

• Schema discovery: "What metadata am I actually using?"
• Standardization planning: "Which fields should I consolidate?"
• Migration prep: "What fields need to be converted?"
• Documentation: "What's the schema of my knowledge base?"

Integration

Works well with other skills:

• vault-field-values: See all unique values for a specific field
• vault-schema-check: Find inconsistencies in field types
• vault-search: Query notes by frontmatter fields

Version: 1.0.0