# Vault Schema

> Analyze all frontmatter fields used across the vault. Triggers on "frontmatter schema", "metadata fields", "what fields exist", "vault schema".

- Skill: `majiayu000/vault-schema` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/vault-schema`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/vault-schema/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/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

| Argument | Required | Description |
|----------|----------|-------------|
| None | - | This skill requires no 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