Does the validation skill block me from creating notes?

No, the validation is non-blocking. It provides warnings and failure reports to help you improve note quality, but it does not prevent the capture or creation of files.

Can I validate all my notes at once?

Yes, by using the '/validate all' or '/validate notes' command, the skill runs a batch process across your entire notes directory and provides a summary report.

What happens if a note is missing a required field like 'description'?

The skill will issue a FAIL status for that specific check and provide a suggested fix, but the rest of the validation process will continue.

How does the skill determine which template to use?

It checks the note's location, the 'type' field in the frontmatter, and looks for specialized schema definitions in the repository's 'ops/templates' directory.

What is 'composability' in the context of this skill?

Composability checks if a note title works as a complete claim (e.g., 'API design requires versioning') rather than just a topic label (e.g., 'API Design'), ensuring notes are easier to reference in other documents.

Note Schema Validator

Name: Note Schema Validator
Author: LopeWale

byLopeWale

•

Learning & Documentation

Automates schema validation and quality checks for markdown notes to ensure structural consistency and content integrity.

The Note Schema Validator is a specialized Claude Code skill designed to maintain high standards in markdown-based documentation and personal knowledge management systems. It performs deep structural analysis of note frontmatter, validating required YAML fields, enum values, and link health against domain-specific templates. By enforcing 'composability'—ensuring note titles act as specific claims rather than generic labels—and auditing description quality, it helps developers and researchers build more rigorous, interconnected, and searchable knowledge bases. Whether used for individual notes or in batch mode across entire directories, this skill provides actionable feedback and suggested fixes to improve documentation utility without blocking the creative workflow.

Key Features

011 GitHub stars

02Template-driven YAML frontmatter validation with mandatory field enforcement

03Description quality auditing to ensure unique context beyond note titles

04Adaptive processing depths (deep, standard, quick) based on repository configuration

05Composability testing to verify that note titles represent clear, specific claims

06Broken link detection for internal wiki-links, topics, and relevant notes

Use Cases

01Ensuring technical notes meet specific structural requirements before being merged

02Enforcing metadata standards in a Zettelkasten or digital garden repository

03Auditing large documentation sets for broken internal links and missing topics

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lopewale/dev_ignition validate

For use in Claude.ai and ChatGPT

Download Skill