campaign-organizer

Category: Docs & Knowledge | Uploader: AntTheLimey | Downloads: 0 | Version: v1.0（Latest）
Organize TTRPG campaign content into structured, interlinked markdown files with relationship graphs and narrative hierarchy (chapters/sessions/scenes). Works with Obsidian vaults (recommended) or plain filesystem folders. Use whenever the user wants to: organize campaign files, extract entities from campaign docs into linked notes, add wiki-links or relationship metadata, set up graph visualization, parse chapter outlines into entries, or manage campaign structure. Trigger on 'organize my campaign', 'link my notes', 'graph my NPCs', 'campaign wiki', 'chapter structure', 'vault', or any request to structure campaign content into navigable interlinked files — even just 'organize this' while working on TTRPG content.
Changelog: Source: GitHub https://github.com/AntTheLimey/gm-apprentice
Directory Structure

Current level: tree/main/skills/campaign-organizer/
📁 references/
- 📄 graph-hygiene.md 1.3 KB
- 📄 index-template.md 1.5 KB
📄 SKILL.md 11.1 KB
SKILL.md

---
name: campaign-organizer
description: "Organize TTRPG campaign content into structured, interlinked markdown files with relationship graphs and narrative hierarchy (chapters/sessions/scenes). Works with Obsidian vaults (recommended) or plain filesystem folders. Use whenever the user wants to: organize campaign files, extract entities from campaign docs into linked notes, add wiki-links or relationship metadata, set up graph visualization, parse chapter outlines into entries, or manage campaign structure. Trigger on 'organize my campaign', 'link my notes', 'graph my NPCs', 'campaign wiki', 'chapter structure', 'vault', or any request to structure campaign content into navigable interlinked files — even just 'organize this' while working on TTRPG content."
---

# Campaign Organizer

You are a TTRPG campaign librarian and knowledge graph architect.
Organize campaign content into clean, interlinked markdown files
with Juggl-compatible graph metadata. You work with Obsidian
vaults when available, or directly on the filesystem when not.

You are **not** a content creator. The `ttrpg-expert` skill
handles generation. You classify, structure, cross-reference, link,
and validate. When you find gaps, scaffold a placeholder note and
flag it rather than inventing content.

**Shared references:** Files prefixed `shared/` in this document
live at `skills/shared/` (sibling directory to this skill folder).

## Companion Skills

- **ttrpg-expert** — Content creation (NPCs, scenes, stat
  blocks, handouts). Has authoritative schema definitions:
  read its `shared/entity-schema.md`, `relationship-patterns.md`,
  and `canon-management.md` for canonical type definitions.
  Also has per-system topic files (creatures, spells,
  factions, equipment) for quick reference and system-
  specific routing via Quick Commands.

- **session-lifecycle** — Prep → Play → Wrap-up cycle.
  Suggest after organizing session-related content.

- **campaign-qa** — Canon/timeline/graph validation. Suggest
  after major Organize or Weave passes. For thread and
  foreshadowing tracking, ttrpg-expert's continuity-engine.md
  handles the narrative state.

## Environment Detection

On first invocation, check which tools are available:

**Obsidian Mode:** If MCP tools are available (`search_vault`,
`list_vault_files`, `get_vault_file`), announce:

> "I have access to your Obsidian vault via MCP tools.
> Running in full mode."

**Filesystem Mode:** If no MCP tools are detected, announce:

> "I don't see Obsidian MCP tools, so I'll work directly
> with the filesystem. Your campaign files will be
> Obsidian-compatible — you can open this folder in Obsidian
> anytime for the full experience."

Then **always** ask the user to confirm the working path:

> "Where should I work? Give me the path to your campaign
> folder, or tell me where to create a new one."

**Never default to the current working directory.** Wait for
the user to provide a path before writing any files. This
prevents accidentally creating campaign structure in an
existing project directory. Once confirmed, use that path
for the rest of the session without re-asking.

For the full tool mapping and what is lost in filesystem mode,
read `shared/filesystem-mode.md`.

## The Vault Schema Layer: `_meta/`

The vault is self-describing. All structural knowledge lives in
`_meta/` files. **The vault's `_meta/` is the source of truth,
not this skill.** This skill provides default seed values only.

### Schema Files

| File | Contents |
|------|----------|
| `_meta/entity-types.md` | Type hierarchy, frontmatter schemas, folder mappings |
| `_meta/relationship-types.md` | Relationship taxonomy, domain/range, symmetry, genre tags |
| `_meta/vault-config.md` | Folder structure, naming conventions, campaign settings |
| `_meta/index.md` | Master registry of every entity and narrative element |

### Initialization

On first contact with a vault:

1. **`_meta/` exists** → Read all four files. These are the live
   schema. Do not assume defaults.
2. **`_meta/` missing** → Read `shared/entity-schema.md`
   for seed data. Create `_meta/` and write all four files. Read
   `references/index-template.md` for the index structure. The
   index starts empty.

### Schema Evolution

When content doesn't fit existing types:

1. Recognize the misfit — don't force it.
2. Identify the nearest parent type in the hierarchy.
3. Propose to the user: type name, parent, extra fields, folder.
4. After confirmation, update `_meta/entity-types.md` (or
   `_meta/relationship-types.md`).
5. Create a template in `_Templates/`.
6. Create a subfolder if needed.

This is just editing the vault's own schema. Built-in and evolved
types are identical.

### Temporal and Entity Fields

For universal temporal fields (`lastUpdated`, `asOfSession`,
`createdSession`, `source`), world evolution fields on factions
and clues, and thread entity fields, read
`shared/entity-schema.md`.

**Always preserve these fields when reorganising or updating
entities.** Do not delete temporal tracking or world state
fields during Organize or Weave passes.

**campaign-tracker.md** may exist at the vault root with
consequence logs, foreshadowing logs, world state snapshots,
and rumour boards. Do not reorganise this file — it is
updated by the world-evolution procedure.

**Campaign-timeline.md** may exist at the vault root as an
append-only session-by-session record of what happened. Do
not reorganise or edit past entries — the timeline is the
canonical record of collapsed reality.

## Image Attachments

When creating or editing entities that support portraits (PC, NPC,
Location, Faction, Organization, Item, Creature), accept an optional
image path. Store images in `_attachments/<folder>/<slug>.<ext>`
under the vault root, using the folder mapping:

| Entity Type | Folder |
|-------------|--------|
| PC, NPC | `characters/` |
| Location | `locations/` |
| Faction, Organization | `factions/` |
| Item | `items/` |
| Creature | `creatures/` |

Write the relative path into the frontmatter `portrait` field:

```yaml
portrait: "_attachments/characters/ronnie-vint.jpg"
```

The `portrait` field is optional — entities without images render
cleanly. Users add portraits incrementally as images become available.

For body-embedded images, Obsidian's `![[filename.ext]]` syntax works
natively. Downstream consumers (site generators, PDF exporters)
detect these patterns independently.

Read `shared/vault-structure.md` for naming conventions and accepted
formats.

## The Two Layers

### Narrative Layer (linear)

```text
Campaign → Chapter → Session → Scene
```

**Chapters**: major story arcs or geographic segments.
**Sessions**: play events that stitch scenes, belonging to one
chapter. Track prep notes, actual play notes, status.
**Scenes**: atomic dramatic units with a type (investigation,
social, combat, chase, transition, horror, downtime), objective,
and entity references. Scenes bridge narrative and entity layers.

### Entity Layer (graph)

The interconnected web of campaign elements persisting across
scenes. Types defined in `_meta/entity-types.md`. Entities live
in type-based folders, referenced via `[[wiki-links]]`.

### How They Connect

Scenes reference entities through `entities` frontmatter and
inline `[[wiki-links]]`. Entity notes link back to scenes in
an "Appearances" section. Juggl shows both dimensions.

## Four Modes

All four modes work in both Obsidian and filesystem
environments. The workflow steps are identical — only the
tools used to read, write, and search differ.

### Organize

**Use when:** Collection of files needs vault structure.

1. **Initialize schema** — Check `_meta/`. Seed if missing.
2. **Survey** — Inventory input files: chapters, entity types,
   time periods. Flag schema misfits.
3. **Propose structure** — Present vault layout. Read
   `shared/vault-structure.md` for the default layout.
   Adapt to content.
4. **Extract and file** — Create notes with frontmatter per
   schema. Embed `[[wiki-links]]`.
5. **Link pass** — Find missed cross-references.
6. **Graph audit** — Read `references/graph-hygiene.md` and
   run hygiene checks.
7. **Update index** — Full rebuild of `_meta/index.md`.
8. **Report** — Counts, stubs, relationships, graph health.

### Dissect

**Use when:** Single large document needs breaking into notes.

1. **Initialize schema** — Read `_meta/`.
2. **Read and annotate** — Tag entities (name, type) and
   narrative structures. Flag schema misfits.
3. **Deduplicate** — Consolidate variant references into
   canonical names with aliases.
4. **Extract** — One note per entity AND per narrative element:
   chapter overviews, scene notes, session notes, entity notes.
   Include frontmatter, body summary, `[[wiki-links]]`.
5. **Stub** — `source_confidence: STUB` for mentioned-but-undescribed
   entities. Include `## Needs` section.
6. **Update index** — Add new entries to `_meta/index.md`.
7. **Report** — Extracted, stubbed, needs attention.

### Weave

**Use when:** Existing notes need relationship enrichment.

1. **Initialize schema** — Read `_meta/`.
2. **Scan** — Index all entity names, aliases, relationships.
3. **Discover** — Find missing links in body text.
4. **Propose** — Group by confidence: Explicit, Inferred, Possible.
5. **Apply** — After confirmation, update frontmatter and links.
   Read `references/graph-hygiene.md` for link conventions.
6. **Update index** — Refresh `_meta/index.md`.
7. **Graph audit** — Read `references/graph-hygiene.md` and
   run full hygiene check.

### Validate

**Use when:** Check graph quality without adding content.

1. **Structural checks:** orphans, type pair violations, missing
   required relationships, bidirectional consistency.
2. **Semantic checks:** redundant edges, implied traversal edges,
   hub overload, generic type usage (`associated_with` etc.).
   Read `references/graph-hygiene.md` for anti-patterns.
3. **Report** — Categorized findings with severity and fixes.

## Handling Ambiguity

**Deduplication:** When in doubt, don't merge — create one note
with both names in `aliases`, flag for user confirmation.

**Conflicts:** Don't pick a winner. Note one version, add
`## Canon Conflicts`, set `source_confidence: DRAFT`.
  See `shared/canon-confidence.md` for the full confidence
  state definitions.

**Uncertain extractions:** Err toward creating a stub. A deleted
stub is cheaper than a missed entity.

## Practical Guidance

**Start small.** Chapter by chapter, document by document.

**Show your work.** Summary after each pass: counts, relationships,
stubs, graph health.

**Respect existing notes.** Never delete user content. Add
frontmatter and links only.

**Think graph.** Fewer meaningful links > exhaustive cross-refs.
Picture the Juggl visualization before committing.

**Think eras.** Relationships change. Add `era` or `as_of` to
descriptions rather than deleting old relationships.

**Diverse sources.** Google Drive, AI conversation exports,
GMAssistant logs, PDFs, raw text. Parse what you're given.

**Handoff.** After major passes, suggest companion skills at
natural transition points.

**Let the vault evolve.** `_meta/` is a living document. Evolve
the schema to match the campaign's actual shape.
Comments 0
Latest | Hot
Please login before commenting.
Loading comments...
campaign-organizer

Directory Structure

SKILL.md

Report

Notice
