godot-mechanic-secrets — Claude Code skill: setup & overview
godot-mechanic-secrets implements cheat combos, Easter egg interactions, hidden wall triggers, and meta persistence in Godot.
LGPL-3.0 327 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-mechanic-secrets -a claude-codeWhat godot-mechanic-secrets does
This skill introduces architectural patterns for Godot secrets and Easter eggs. Instead of checking key presses inside _process, it uses a time-windowed input buffer for combos like the Konami code. Secret wall inspection relies on vector dot products rather than continuous physics raycasts.
Global rewards and gallery flags are routed to user://secrets.cfg. This guarantees that metadata survives even if the player wipes standard campaign save slots. To prevent macro abuse, a dedicated lockout guard penalizes rapid failed cheat attempts.
Legacy scripts such as input_sequence_watcher.gd are replaced in favor of modular secret_* components.
What it helps with
- register button sequences using a time-sensitive input buffer
- trigger interactions after repeated clicks on an object
- detect hidden areas via dot-product orientation without raycasts
- save meta-progression to
user://secrets.cfgacross profile resets - block macro brute-forcing with an anti-cheat lockout guard
Example prompts for the agent
- Implement a Konami cheat sequence using SecretSequenceComboMatcher
- Store secret gallery flags in user://secrets.cfg outside standard save slots
- Create a hidden passage detector based on player view dot product
How to install godot-mechanic-secrets
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-mechanic-secrets -a claude-code2Manually: put the files in place
~/.claude/skills/godot-mechanic-secrets/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-mechanic-secrets/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-mechanic-secrets -a codex2Manually: put the files in place
.agents/skills/godot-mechanic-secrets/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-mechanic-secrets -a cursor2Manually: put the files in place
.cursor/skills/godot-mechanic-secrets/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-mechanic-secrets2Manually: put the files in place
.github/skills/godot-mechanic-secrets/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-mechanic-secrets -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-mechanic-secretsManually: put the files in place
.devin/skills/godot-mechanic-secrets/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-mechanic-secrets -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-mechanic-secrets
How to install godot-mechanic-secrets in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-mechanic-secrets -a claude-code. The file will be placed in ~/.claude/skills/godot-mechanic-secrets/SKILL.md.
Why use user://secrets.cfg instead of regular save files?
Normal save slots get deleted when resetting a run. Storing achievements and unlocked gallery flags in user://secrets.cfg preserves player meta-progress across saves.
How does it detect when a player spots a secret?
It calculates the dot product between the player orientation and the target vector instead of polling continuous physics raycasts.