How do I install the Wsc Entities skill?

Run npx skillmds@latest add majiayu000/wsc-entities in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Wsc Entities safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wsc Entities?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Wsc Entities free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Wsc Entities?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wsc Entities by majiayu000 — Agent Skill

Name: Wsc Entities
Rating: 4.5 (4 reviews)
Author: majiayu000

Wsc Entities

Create, validate, and query WSC world entities (polities, agents, regions, forces, locales, holdings). Use when working with entity JSON files, checking entity consistency, or finding entities by type, tag, or relationship.

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

WSC Entity Management

Manage entities in the World State Chronicler. Entities are JSON files representing game world objects like factions, characters, locations, and assets.

Entity Types

Type	Description	ID Format
`polity`	Faction, nation, guild	`polity.slug`
`region`	Star system, province	`region.slug`
`presence`	Polity-region relationship	`presence.polity.region`
`force`	Fleet, army, warband	`force.slug`
`locale`	Station, city, dungeon	`locale.slug`
`feature`	Planet, terrain, anomaly	`feature.slug`
`link`	Route, jump lane, portal	`link.a.b`
`site`	District, zone within locale	`site.locale.slug`
`agent`	Character, hero, leader	`agent.slug`
`holding`	Asset, artifact, ship	`holding.slug`

Commands

Validate an Entity

npx tsx .claude/skills/wsc-entities/scripts/validate.ts <entity-file-or-id>

Validates entity JSON against the schema. Reports errors and warnings.

Query Entities

# By type
npx tsx .claude/skills/wsc-entities/scripts/query.ts --type agent

# By tag
npx tsx .claude/skills/wsc-entities/scripts/query.ts --tag veteran

# By affiliation/belongs-to
npx tsx .claude/skills/wsc-entities/scripts/query.ts --belongs-to polity.hegemony

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

# Combined filters
npx tsx .claude/skills/wsc-entities/scripts/query.ts --type force --belongs-to polity.free_traders

Create Entity Template

npx tsx .claude/skills/wsc-entities/scripts/create.ts <type> <slug> [--name "Display Name"]

Creates a new entity JSON file from template.

List All Entities

npx tsx .claude/skills/wsc-entities/scripts/query.ts --list

Entity Structure

All entities share this base structure:

{
  "id": "type.slug",
  "type": "entity_type",
  "name": "Display Name",
  "tags": ["tag1", "tag2"],
  "attrs": { /* type-specific */ },
  "ai": { /* optional LLM integration */ }
}

AI Block (for characters and factions)

{
  "ai": {
    "persona": "Character identity description",
    "voice": {
      "tone": "weary | formal | aggressive",
      "vocabulary": ["preferred", "terms"],
      "speech_patterns": "Quirks and patterns"
    },
    "goals": ["objective_1", "objective_2"],
    "memory": ["evt_id_1", "evt_id_2"],
    "secrets": ["hidden fact 1"],
    "emotional_state": {
      "mood": "guarded",
      "stress": 0.6
    },
    "skills": {
      "combat": 0.8,
      "negotiation": 0.6
    }
  }
}

File Locations

Live world: src/world/entities/
Examples: src/examples/entities/

Examples

See examples documentation for complete entity examples.

---name: wsc-entitiesdescription: Create, validate, and query WSC world entities (polities, agents, regions, forces, locales, holdings). Use when working with entity JSON files, checking entity consistency, or finding entities by type, tag, or relationship.--- # WSC Entity Management Manage entities in the World State Chronicler. Entities are JSON files representing game world objects like factions, characters, locations, and assets. ## Entity Types | Type | Description | ID Format | |------|-------------|-----------| | `polity` | Faction, nation, guild | `polity.slug` | | `region` | Star system, province | `region.slug` | | `presence` | Polity-region relationship | `presence.polity.region` | | `force` | Fleet, army, warband | `force.slug` | | `locale` | Station, city, dungeon | `locale.slug` | | `feature` | Planet, terrain, anomaly | `feature.slug` | | `link` | Route, jump lane, portal | `link.a.b` | | `site` | District, zone within locale | `site.locale.slug` | | `agent` | Character, hero, leader | `agent.slug` | | `holding` | Asset, artifact, ship | `holding.slug` | ## Commands ### Validate an Entity ```bash npx tsx .claude/skills/wsc-entities/scripts/validate.ts <entity-file-or-id> ``` Validates entity JSON against the schema. Reports errors and warnings. ### Query Entities ```bash # By type npx tsx .claude/skills/wsc-entities/scripts/query.ts --type agent # By tag npx tsx .claude/skills/wsc-entities/scripts/query.ts --tag veteran # By affiliation/belongs-to npx tsx .claude/skills/wsc-entities/scripts/query.ts --belongs-to polity.hegemony # By location npx tsx .claude/skills/wsc-entities/scripts/query.ts --location region.vega # Combined filters npx tsx .claude/skills/wsc-entities/scripts/query.ts --type force --belongs-to polity.free_traders ``` ### Create Entity Template ```bash npx tsx .claude/skills/wsc-entities/scripts/create.ts <type> <slug> [--name "Display Name"] ``` Creates a new entity JSON file from template. ### List All Entities ```bash npx tsx .claude/skills/wsc-entities/scripts/query.ts --list ``` ## Entity Structure All entities share this base structure: ```json { "id": "type.slug", "type": "entity_type", "name": "Display Name", "tags": ["tag1", "tag2"], "attrs": { /* type-specific */ }, "ai": { /* optional LLM integration */ } } ``` ### AI Block (for characters and factions) ```json { "ai": { "persona": "Character identity description", "voice": { "tone": "weary | formal | aggressive", "vocabulary": ["preferred", "terms"], "speech_patterns": "Quirks and patterns" }, "goals": ["objective_1", "objective_2"], "memory": ["evt_id_1", "evt_id_2"], "secrets": ["hidden fact 1"], "emotional_state": { "mood": "guarded", "stress": 0.6 }, "skills": { "combat": 0.8, "negotiation": 0.6 } } } ``` ## File Locations - **Live world**: `src/world/entities/` - **Examples**: `src/examples/entities/` ## Examples See [examples documentation](../../../src/examples/README.md) for complete entity examples.

Frequently asked questions