nddipiazza/robos / .agents/skills/crpg-game-builder
crpg-game-builder
VerifiedBuild, validate, and maintain party-based tactical isometric cRPGs in Godot 4 using the RobOS Dual-State Knowledge Graph, Flare RPG assets, and D&D 5e SRD rules.
RobOS cRPG Game Builder (crpg-game-builder)
Build, balance, and maintain party-based tactical isometric cRPGs (Infinity Engine / Baldur's Gate style) using the RobOS Dual-State Knowledge Graph and Godot 4.
Architecture & Separation of Concerns
- Semantic Graph Layer (
.robos/kgraphs/crpg/package.jsonld):- Master definition of the game world: Classes, Monsters, Spells, Items, Quests, Dialogue Trees, Map Zones, Test Suites, and Agent Sessions.
- Governed by W3C SHACL shape validation (
CRPGGameShape,CRPGMonsterShape, etc.). - Dual-state semantic diffing (
kgraph diff main) detects broken dialogue references, missing sprite bindings, and level balance issues before code generation.
- Open-Source Asset Pipeline:
- Ingests Flare RPG (
flareteam/flare-game) CC-BY-SA 3.0 assets: 100+ animated 8-directional isometric creatures, modular paperdoll armor/weapons, isometric environmental tilesets, icons, and audio. - Ingests Game-Icons.net (4,000+ vector icons) and OpenGameArt collections.
- Ingests Flare RPG (
- Engine Runtime Layer (
games/crpg-realm/):- Decoupled Godot 4 GL Compatibility game project.
- Consumes compiled JSON data files (
data/v1/*.json), validated against JSON Schemas (schemas/v1/*.json). - Uses generated statically-typed GDScript data models (
src/generated/v1/*.gd). - Embedded
GameControlServer.gdHTTP REST service for live telemetry and headless E2E action injection. - Real-Time with Pause (RTwP) combat controller and isometric party navigation.
- Xvfb RobOS Agent Session & Cucumber E2E Verification:
- Runs Godot 4 in an isolated headless Xvfb virtual display (
:99). - Captures high-definition MP4 video proof-of-work via FFmpeg.
- Asserts game telemetry via
GET /api/v1/stateand injects actions viaPOST /api/v1/action. - Generates interactive HTML reports with embedded video players and GameState JSON inspections.
- Runs Godot 4 in an isolated headless Xvfb virtual display (
Commands & Workflows
1. Re-Generate Engine Code and Data from Knowledge Graph
Run the generator whenever the KGraph is updated:
node packages/crpg-builder/bin/crpg-builder.js generate
2. Validate KGraph Shape Integrity
node packages/crpg-builder/bin/crpg-builder.js validate
3. Verify Data Store Integrity
python3 games/crpg-realm/tests/validate_schemas.py
4. Run Automated Unit Tests
npm --prefix packages/crpg-builder test
5. Run Full Playthrough E2E Simulation
Simulates the entire 30-minute Early Access game loop from Character Selection through Homestead, Village Square, Garrison Keep, Boss Combat, and Terminal Victory State:
python3 games/crpg-realm/tests/test_playthrough_slice.py
6. Run Cucumber E2E Test Suite in Xvfb with Video Capture
Runs the automated BDD Cucumber suite on an isolated virtual display with video proof-of-work (mirroring Dragon Warrior):
python3 games/crpg-realm/run_cucumber_tests.py
Outputs:
- Videos:
games/crpg-realm/tests/e2e/reports/videos/<scenario>.mp4 - Telemetry:
games/crpg-realm/tests/e2e/reports/gamestate_<scenario>.json - Interactive HTML Report:
games/crpg-realm/tests/e2e/reports/index.html
7. Run Godot 4 Headless Verification
./games/crpg-realm/debug.sh --scene TestRunner --headless
8. Programmatic Agent Session Execution
const { XvfbRobOSAgentSession } = require('packages/crpg-builder/lib/xvfb-agent-session');
const session = new XvfbRobOSAgentSession({ display: ':99', webPort: 18090 });
const result = await session.runE2ESuite();
console.log('Passed:', result.success, 'Artifacts:', result.artifacts);
Adding New Content to the Game
Adding a Monster
Add a new node to .robos/kgraphs/crpg/package.jsonld:
{
"@id": "urn:robos:crpg:monster:dire-wolf",
"@type": ["oslc_am:Resource", "robos:CRPGMonster", "schema:Person"],
"dcterms:title": "Dire Wolf",
"robos:challengeRating": "1",
"robos:armorClass": 14,
"robos:hitPoints": 37,
"robos:speed": 50,
"robos:abilities": { "STR": 17, "DEX": 15, "CON": 15, "INT": 3, "WIS": 12, "CHA": 7 },
"robos:spriteAssetRef": "flare:creature:wolf",
"robos:package": "crpg",
"robos:namespace": "robos.crpg"
}
Adding a Spell
{
"@id": "urn:robos:crpg:spell:bless",
"@type": ["oslc_am:Resource", "robos:CRPGSpell", "schema:Action"],
"dcterms:title": "Bless",
"robos:spellLevel": 1,
"robos:magicSchool": "Enchantment",
"robos:castingTime": "1 action",
"robos:range": "30 feet",
"robos:damageFormula": "1d4",
"robos:damageType": "buff",
"robos:package": "crpg",
"robos:namespace": "robos.crpg"
}
After modifying the graph:
- Run
node packages/crpg-builder/scripts/sync-aggregate.js - Run
node packages/crpg-builder/bin/crpg-builder.js generate - Run
python3 games/crpg-realm/run_cucumber_tests.py
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |