validate-template

name	validate-template
description	Validate a template or entity file has all required sections, YAML fields, and follows the worldbuilding system conventions. Use when creating new templates or checking if entities are properly structured.
argument-hint	[template or entity path] [--fix] [--template-type Type]

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/ ===

Category             | Files | Valid | Issues |
---------------------|-------|-------|--------|
Characters           | 6     | 6     | 0      |
Settlements          | 8     | 7     | 1      |
Items                | 11    | 11    | 0      |
Creatures            | 5     | 5     | 0      |
Organizations        | 9     | 9     | 0      |
Concepts             | 10    | 9     | 1      |
History              | 9     | 9     | 0      |
Geography            | 18    | 18    | 0      |
Encounters           | 4     | 4     | 0      |
Maps                 | 4     | 4     | 0      |
---------------------|-------|-------|--------|
TOTAL                | 84    | 82    | 2      |

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/ ===

Category             | Files | Valid | Issues |
---------------------|-------|-------|--------|
Characters           | 12    | 10    | 2      |
Settlements          | 8     | 8     | 0      |
...

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