Claude Code Plugins

Community-maintained marketplace

Feedback

wsc-chronicle

@mattnigh/skills_collection
1
0

Emit and query WSC chronicle events. Use when recording world events, checking event history, tracing causality chains, or finding events by type, location, or participants.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name wsc-chronicle
description Emit and query WSC chronicle events. Use when recording world events, checking event history, tracing causality chains, or finding events by type, location, or participants.
allowed-tools Read, Write, Bash, Glob

WSC Chronicle Management

The chronicle is an append-only event log that records everything that happens in the world. Events are stored in NDJSON format (one JSON object per line).

Event Structure

{
  "id": "evt_10001",
  "t_world": 1042.5,
  "t_stream": "02:14:33",
  "type": "battle.resolved",
  "where": "region.vega",
  "who": ["force.7th_fleet", "force.raiders"],
  "data": { /* event-specific payload */ },
  "causes": ["evt_10000"],
  "source": "lens.galactic",
  "confidence": 0.95,
  "importance": 0.8,
  "narrative_summary": "Human-readable description..."
}

Event Types

Family Types Description
Governance treaty.signed, control.changed, election.held Political events
Economy shortage.started, route.established, trade.completed Economic events
Conflict conflict.started, battle.resolved, asset.captured Military events
Discovery anomaly.discovered, artifact.recovered Exploration events
Character agent.promoted, agent.killed, agent.defected Character events
Settlement infrastructure.completed, unrest.spike City/locale events
Scene dialogue.occurred, skill_check.attempted, secret.revealed RPG events
Opportunity opportunity.created, opportunity.resolved Drill-down hooks

Commands

Emit an Event

npx tsx .claude/skills/wsc-chronicle/scripts/emit.ts \
  --type battle.resolved \
  --where region.vega \
  --who force.7th_fleet,force.raiders \
  --data '{"outcome": "raider_victory"}' \
  --importance 0.8 \
  --summary "Raiders ambushed the 7th Fleet..."

Query Events

# Recent events
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --last 10

# By type
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --type battle.resolved

# By location
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --where region.vega

# By participant
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --who agent.captain_reva

# By importance threshold
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --min-importance 0.7

# Time range
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --after 1040 --before 1050

# Combined
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --type conflict.* --where region.vega --min-importance 0.5

Trace Causality

# Find what caused an event
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --causes-of evt_10492

# Find what an event caused
npx tsx .claude/skills/wsc-chronicle/scripts/query.ts --caused-by evt_10311

Importance Scores

Events carry an importance score (0-1) used for artifact generation:

Score Meaning Examples
0.9+ Major turning point War declared, leader killed
0.7-0.9 Significant Battle won, alliance formed
0.5-0.7 Notable Skirmish, trade deal
0.3-0.5 Minor Patrol, routine event
<0.3 Background Ambient events

File Location

  • Chronicle: src/world/chronicle.ndjson
  • Example events: src/examples/events/