vault-validate

Validate vault note frontmatter against the v2 schema and emit JSON reports.

1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/wtyler2505/ProtoPulse --skill vault-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-validate
Source: https://github.com/wtyler2505/ProtoPulse/tree/main/.claude/skills/vault-validate
Command: npx skills add https://github.com/wtyler2505/ProtoPulse --skill vault-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, jsonschema, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

Validates vault knowledge notes against the v2 frontmatter schema to ensure consistent metadata, enforce data quality, and enable reliable cross-link checks across the vault.

Core Features & Use Cases

  • Validates required fields (name, description, type, topics) and recommended fields (audience, reviewed, confidence).
  • Performs cross-link integrity checks for related, supersedes, and superseded-by fields, and flags orphan notes or missing MOC membership.
  • Emits machine-readable JSON alongside human-readable summaries to support automation, audits, and governance.

Quick Start

Run vault-validate on knowledge/**/*.md to generate a report of frontmatter violations.

Frequently Asked Questions about vault-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate frontmatter metadata in markdown knowledge notes?

You can validate frontmatter by running a schema check against markdown notes to enforce required fields like name, description, type, and topics. This ensures consistent metadata and reliable data quality across your knowledge vault.

What is frontmatter schema validation for a knowledge vault?

Frontmatter schema validation checks YAML metadata in markdown notes against a predefined structure to enforce data quality. It verifies required fields, cross-links, MOC membership, and freshness across all knowledge entries.

How do I check cross-link integrity and orphan notes in a vault?

Check cross-link integrity and identify orphan notes by validating related, supersedes, and superseded-by frontmatter fields. This flags notes missing MOC membership and reports broken links with actionable violation details.

Does vault validation require PyYAML and jsonschema dependencies?

Vault validation requires PyYAML to parse frontmatter, while jsonschema is an optional dependency for schema enforcement. You need these libraries installed to process markdown files and validate metadata structures.

Can I output machine-readable JSON reports for frontmatter violations?

You can output machine-readable JSON reports alongside human-readable summaries when validating frontmatter violations. This dual-output format supports automation, audits, and governance workflows for vault notes.