agentleFS
alainatoralainator/worldcodex/.claude/skills/writing-worldbuilding/SKILL.md

writing-worldbuilding

Skill2 starsChanged 7 months agoMITView on GitHub

Writes new worldbuilding content: civilizations, characters, locations, factions, events, languages, or narrative elements. Use when creating new entries, expanding existing ones, or when user says "create", "write", "add", "flesh out", "build", or "expand" for any non-science content. Does NOT write science files — use /writing-science for that.

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. About 0 are common, 13 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Write new non-science worldbuilding content following repo conventions.

    line 15
  2. Distinctive:

    Read CLAUDE.md for conventions and locked spellings

    line 19
  3. Very specific:

    Read references/writing-standards.md for prose anti-patterns

    line 20
  4. Distinctive:

    If the project has a foundations audit toolkit, read it when writing civilizations, conflicts, or recovery arcs

    line 21
  5. Distinctive:

    Search existing files for related content (grep key terms)

    line 23
  6. Distinctive:

    Check science directories for universal rules the content must obey

    line 24
  7. Distinctive:

    Add YAML frontmatter: title, tags, status: draft

    line 28
  8. Distinctive:

    When creating a civilization, address: governance, cultural identity, economy, technology, internal tensions, external relations, and how …

    line 49
  9. Distinctive:

    Update the relevant _index.md

    line 55
  10. Distinctive:

    Add new terms to GLOSSARY.md

    line 56
  11. Distinctive:

    Add dated events to MASTER-TIMELINE.md

    line 57
  12. Distinctive:

    Does NOT write science files (use /writing-science).

    line 62
  13. Distinctive:

    Does NOT audit content (use /auditing-canon).

    line 63
  14. Distinctive:

    Does NOT design physical world foundations (use /designing-worlds).

    line 64

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Writing Worldbuilding

Write new non-science worldbuilding content following repo conventions.

Prerequisites

  1. Read CLAUDE.md for conventions and locked spellings
  2. Read references/writing-standards.md for prose anti-patterns
  3. If the project has a foundations audit toolkit, read it when writing civilizations, conflicts, or recovery arcs
  4. Search existing files for related content (grep key terms)
  5. Check science directories for universal rules the content must obey

Process

  1. Add YAML frontmatter: title, tags, status: draft
  2. One entity per file — no mega-documents
  3. kebab-case filenames
  4. Cross-link to related files with relative markdown links
  5. Flag potential contradictions: <!-- REVIEW: potential conflict with [file] -->

Derivation-First Builds

For civilizations being built from scratch — especially in novel environments or with non-human species — use /civilization-build instead of the scaffold below. The scaffold's categories (governance, economy) are useful shorthand for human civilizations in familiar contexts, but they can import assumptions when applied to novel situations. The /civilization-build command ensures every social structure is derived from biology and environment first.

The scaffold below remains useful for quick expansions of existing civilizations or for human civilizations in Earth-like contexts where the derivation has already been done (implicitly, by history).

Civilization Scaffold

When creating a civilization, address: governance, cultural identity, economy, technology, internal tensions, external relations, and how they interpret the universe's fundamental forces.

After Writing

  • Update the relevant _index.md
  • Add new terms to GLOSSARY.md
  • Add dated events to MASTER-TIMELINE.md
  • Present for author review — do NOT commit

Out of Scope

Does NOT write science files (use /writing-science). Does NOT audit content (use /auditing-canon). Does NOT design physical world foundations (use /designing-worlds).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.