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:

yaml

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

markdown

# {{title}}

markdown

# [Entity Name]

Checks:

• H1 heading exists as first content line after YAML
• Only one H1 heading in file

Connections Section

markdown

## Connections

### [Category]
- **[Relationship]:** [[Entity]]

Checks:

• ## Connections section exists
• At least one subsection with wikilinks
• Wikilinks use proper format [[Entity Name]]

Image Prompts Section

markdown

## 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:

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:

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:

yaml

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

Additional Sections:

• ## Overview
• ## Districts or ## Areas
• ## Notable Locations

Organizations

Additional YAML:

yaml

organization_type: "[type]"  # or appropriate tag

Additional Sections:

• ## Overview
• ## Leadership
• ## Goals
• ## Resources

Creatures (Monster, Animal, Insect)

Additional YAML:

yaml

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

Additional Sections:

Geography

Additional YAML:

yaml

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

Additional Sections:

• ## Overview
• ## Features
• ## Inhabitants

Items

Additional YAML:

yaml

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

Additional Sections:

• ## Description
• ## Properties

History (Event, Age, War, Battle)

Additional YAML:

yaml

date: "[date or era]"

Additional Sections:

• ## Overview
• ## Causes
• ## Key Figures
• ## Consequences

Validation Report

code

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

bash

/validate-template --all-templates

Report:

code

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

bash

/validate-template --all-entities Eldermyr

Report:

code

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

bash

# 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

Validate Template

Overview

Instructions

Parse Arguments

Validation Rules

Universal Requirements (All Files)

YAML Frontmatter

Title Section

Connections Section

Image Prompts Section

Category-Specific Requirements

Characters (Protagonist, Antagonist, Support Character)

Settlements (Village, Town, City, Stronghold)

Organizations

Creatures (Monster, Animal, Insect)

Geography

Items

History (Event, Age, War, Battle)

Validation Report

Auto-Fix Mode (--fix)

Bulk Validation

Validate All Templates

Validate All Entities in World

Integration with Other Skills

Before /create-template

After /create-entity

With /audit-world

Examples

Before `/create-template`

After `/create-entity`

With `/audit-world`