world-building

Generate and update five worldview files for the waifu platform.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/gonggqing/waifus-workflow --skill world-building-gonggqing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: world-building
Source: https://github.com/gonggqing/waifus-workflow/tree/main/.agents/skills/world-building
Command: npx skills add https://github.com/gonggqing/waifus-workflow --skill world-building-gonggqing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you create and maintain structured worldview data for the waifu platform by generating and updating five core files (world.md, factions.md, locations.md, timeline.md, and characters.md) and guiding consistent world-building workflows.

Core Features & Use Cases

  • Create and organize world data: initializes a new worldview directory with the five core files, including world abstract, overview, rules, culture, factions, locations, timeline, and character registry.
  • Expand existing worlds: appends new factions, locations, events, and characters in a controlled, append-only manner while preserving coherence.
  • Mode-aware pipelines: Mode 1 for creating new worldviews from character concept; Mode 2 for expanding an existing worldview when new characters are added.
  • Quality and consistency guards: flags contradictions with <!-- ⚠️ 待协调:[issue] --> and ensures frontmatter-driven discovery as the source of truth.

Quick Start

Create a new worldview concept and I will generate the five core files: world.md, factions.md, locations.md, timeline.md, and characters.md.

Frequently Asked Questions about world-building

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create structured worldbuilding files for a new worldview concept?

To create a worldview, you generate five core files: world.md, factions.md, locations.md, timeline.md, and characters.md. This initializes a structured directory encompassing the world abstract, rules, culture, factions, and character registry.

What is the best way to expand an existing worldview without breaking internal lore coherence?

The best way to expand a worldview is using an append-only pipeline that adds new factions, locations, and characters while preserving internal coherence. The system flags any contradictions with a warning comment for manual resolution.

How does the workflow differentiate between creating a new world and adding characters to an existing one?

The workflow uses mode-aware pipelines to differentiate tasks: Mode 1 generates a new worldview from a character concept, while Mode 2 appends new character data to an existing worldview directory without overwriting established lore.

Can I use markdown templates to manage factions, locations, and timeline data?

Yes, you can use enforced markdown templates to manage factions, locations, and timeline data. The system relies on frontmatter-driven discovery within these files to serve as the single source of truth for your worldbuilding data.

How are lore contradictions handled when appending new events or cultural details?

When new events or cultural details conflict with existing lore, the system flags the contradictions using a specific HTML comment tag. This ensures you can identify and manually coordinate inconsistencies without silently breaking the worldview.