godot-genre-romance — Claude Code skill: date routes and NPC schedules
godot-genre-romance is a Claude Code skill for structuring Godot dating sims with multi-axis relationship stats, story branching, and NPC schedules.
LGPL-3.0 304 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-romance -a claude-codeWhat godot-genre-romance does
This skill guides the design of dating sims and social simulators in Godot. Instead of a single affection counter, it introduces a three-axis metric covering Attraction, Trust, and Comfort. Dating systems apply a repetition penalty of roughly 30% for picking the same venue back-to-back, while relationship milestones unlock character routes and register CG gallery flags.
The blueprint builds around dedicated scripts: affection_manager.gd handles gifts and stat thresholds, date_event_system.gd evaluates date locations, and route_manager.gd enforces story locks. NPC reactions and jealousy broadcast across scenes using Godot node groups, while schedules listen to an Autoload TimeManager signal bus.
Writing narrative trees directly in code breaks this pattern. Dialogue branches must reside in custom Resource files, and large story chunks require ResourceLoader.load_threaded_request() so screen transitions remain stutter-free.
What it helps with
- implement a multi-axis relationship model tracking attraction, trust, and comfort
- apply repetition penalties to repeated date locations
- organize route branching and unlocked CG gallery tracking
- manage NPC daily schedules using signal-based time updates
Example prompts for the agent
- Build a dating event system in Godot with repetition penalties for repeated venues
- Configure character affection using the three-axis Attraction, Trust, and Comfort model
- Set up route locking and CG flags using route_manager.gd patterns
How to install godot-genre-romance
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-romance -a claude-code2Manually: put the files in place
~/.claude/skills/godot-genre-romance/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-genre-romance/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-romance -a codex2Manually: put the files in place
.agents/skills/godot-genre-romance/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-romance -a cursor2Manually: put the files in place
.cursor/skills/godot-genre-romance/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-genre-romance2Manually: put the files in place
.github/skills/godot-genre-romance/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-romance -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-genre-romanceManually: put the files in place
.devin/skills/godot-genre-romance/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-romance -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-genre-romance
How do I install godot-genre-romance in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-romance -a claude-code in your terminal. The file is placed at ~/.claude/skills/godot-genre-romance/SKILL.md.
What does godot-genre-romance do?
It gives coding agents proven architectural rules for relationship mechanics, schedule broadcasting, and route branching in Godot engine projects.
Why does this blueprint reject polling NPC schedules in _process?
Checking NPC states on every frame hurts performance. The blueprint enforces an Autoload TimeManager that broadcasts signals only when hours or days change.