Validate Template

Validate: $ARGUMENTS

Overview

This skill validates that templates and entity files conform to the worldbuilding system standards:

• Required YAML frontmatter fields are present

• Required sections exist

• Image Prompts section is properly formatted

• Connections section has correct structure

• Content follows directive patterns

Instructions

Parse Arguments

Argument Purpose

[path]

Path to template or entity file

--fix

Auto-fix simple issues (add missing sections)

--template-type [Type]

Force validation as specific type

--all-templates

Validate all templates in Templates/

--all-entities [world]

Validate all entities in a world

Validation Rules

Universal Requirements (All Files)

YAML Frontmatter

Every file must have:

tags:

• [category tag] name: "[Entity Name]" aliases:
• [optional aliases] status: draft | in-progress | complete image: "" | "[[Entity Name.png]]"

Checks:

• YAML block exists (between --- markers)

• tags: field exists and is non-empty array

• name: field exists and is non-empty string

• aliases: field exists (can be empty array)

• status: field exists with valid value

• image: field exists

Title Section

{{title}}

or

[Entity Name]

Checks:

• H1 heading exists as first content line after YAML

• Only one H1 heading in file

Connections Section

Connections

[Category]

• [Relationship]: [[Entity]]

Checks:

• Connections

section exists

• At least one subsection with wikilinks

• Wikilinks use proper format [[Entity Name]]

Image Prompts Section

Image Prompts

[Art Style]

[Style description]

[Scene Type]

[Scene setup]

Prompt: [Filled prompt text]

Checks:

• Image Prompts

section exists (for most entity types)

• At least one subsection with Prompt: field

• Prompt: field contains actual content (not placeholder)

Category-Specific Requirements

Characters (Protagonist, Antagonist, Support Character)

Additional YAML:

species: "[species]" class: "[class]" level: [number] # OR challenge_rating: "[CR]" # (one required, not both) armor_class: [number] hit_points: [number] proficiency_bonus: [number]

Additional Sections:

• Stat Block

• Ability Scores

• Personality

• Background

• Combat Statistics

Validation Notes:

• Either level: OR challenge_rating: must be filled (not both, not neither)

• Proficiency bonus must match level/CR per D&D 5e 2024 rules

Settlements (Village, Town, City, Stronghold)

Additional YAML:

settlement_type: "[type]" population: "[range]" government_type: "[type]"

Additional Sections:

• Overview

• Districts

or ## Areas

• Notable Locations

Organizations

Additional YAML:

organization_type: "[type]" # or appropriate tag

Additional Sections:

• Overview

• Leadership

• Goals

• Resources

Creatures (Monster, Animal, Insect)

Additional YAML:

size: "[size]" creature_type: "[type]" challenge_rating: "[CR]" experience_points: [number]

Additional Sections:

• Stat Block

• Classification

• Ability Scores

• Traits

• Actions

Geography

Additional YAML:

terrain_type: "[type]" # or appropriate geographic tag

Additional Sections:

• Overview

• Features

• Inhabitants

Items

Additional YAML:

rarity: "[rarity]" item_type: "[type]"

Additional Sections:

• Description

• Properties

History (Event, Age, War, Battle)

Additional YAML:

date: "[date or era]"

Additional Sections:

• Overview

• Causes

• Key Figures

• Consequences

Validation Report

=== VALIDATION REPORT: [File Name] ===

Template Type: [Detected or Specified] Category: [Category]

YAML FRONTMATTER ───────────────────────────────────── ✓ tags: present (3 tags) ✓ name: present ("Lord Varic Valdren") ✓ aliases: present (2 aliases) ✓ status: present (in-progress) ✓ image: present (empty - needs image) ✓ species: present ("Human") ✓ class: present ("Fighter") ✓ level: present (8) ✗ challenge_rating: N/A (using level-based) ✓ armor_class: present (18) ✓ hit_points: present (75) ✓ proficiency_bonus: present (+3) ✓ Matches level 8

REQUIRED SECTIONS ───────────────────────────────────── ✓ # Title (line 15) ✓ ## Stat Block (line 20) ✓ ### Ability Scores (line 25) ✓ ## Personality (line 60) ✓ ## Background (line 80) ✓ ## Combat Statistics (line 45) ✓ ## Connections (line 200) ✓ ## Image Prompts (line 230)

IMAGE PROMPTS ───────────────────────────────────── ✓ ### Portrait found ✓ Prompt: filled (45 characters) ✓ ### Action Scene found ✗ Prompt: EMPTY or placeholder

CONNECTIONS ───────────────────────────────────── ✓ Has wikilinks in Connections section

• [[Lady Serana Valdren]]
• [[House Valdren]]
• [[Aldersgate]]

SUMMARY ───────────────────────────────────── Checks Passed: 18/20 Checks Failed: 2 Warnings: 1

ISSUES FOUND:

1. [ERROR] Image Prompt for "Action Scene" is empty (line 245)
2. [WARNING] image: field is empty (entity has no generated image)

RECOMMENDATIONS:

• Fill the Action Scene prompt before running /generate-image
• Run /generate-image after filling prompts

Auto-Fix Mode (--fix)

When --fix is specified, the skill can automatically fix:

Issue Auto-Fix Action

Missing YAML field Add field with placeholder value

Missing required section Add section header with TODO comment

Missing Connections section Add empty Connections section

Missing Image Prompts section Add template Image Prompts section

Empty aliases array Add aliases: []

Cannot auto-fix:

• Missing content in sections

• Empty image prompts (requires creative content)

• Incorrect stat block values

• Missing wikilinks

Bulk Validation

Validate All Templates

/validate-template --all-templates

Report:

=== TEMPLATE VALIDATION: Templates/ ===

FILES WITH ISSUES:

• Templates/Settlements/Tavern.md: Missing ## Notable NPCs section
• Templates/Concepts/Religion.md: Empty image prompt

Validate All Entities in World

/validate-template --all-entities Eldermyr

Report:

=== ENTITY VALIDATION: Worlds/Eldermyr/ ===

ENTITIES WITH ISSUES:

• Characters/Old Merchant.md: Missing level OR challenge_rating
• Characters/Guard Captain.md: Proficiency +2 doesn't match level 7

Integration with Other Skills

Before /create-template

Run validation on similar templates to understand the expected structure.

After /create-entity

Run validation to ensure generated entity meets all requirements.

With /audit-world

Validation is complementary to audit:

• /validate-template checks structure and format

• /audit-world checks content consistency and links

Examples

Validate a single entity

/validate-template "Worlds/Eldermyr/Characters/Lord Varic Valdren.md"

Validate and auto-fix issues

/validate-template "Worlds/Eldermyr/Characters/Lord Varic Valdren.md" --fix

Validate as specific type

/validate-template "some-file.md" --template-type "Support Character"

Validate all templates

/validate-template --all-templates

Validate all entities in a world

/validate-template --all-entities Eldermyr

Validate with auto-fix

/validate-template --all-entities Eldermyr --fix