validate-template

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

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 |

---

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

```

or

```markdown

# [Entity Name]

```

Checks:

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

#### Connections Section

```markdown

[Category]

• [Relationship]: [[Entity]]

```

Checks:

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

#### Image Prompts Section

```markdown

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

• [ ] ## 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:

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

• [ ] ## Stat Block
• [ ] ### Classification
• [ ] ### Ability Scores
• [ ] ## Traits
• [ ] ## Actions

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

```

---

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

---

Validate All Templates

```bash

/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

```bash

/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

```

---

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

---

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

```