Godot Mechanic Secrets

What it does

When your agent uses it

• Adding Konami-style codes
• Curiosity spam eggs
• Lockout anti-brute-force
• Gallery flags that must survive slot deletes

Example prompts

• “/godot-mechanic-secrets”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1Event-Based Combo Detection - Avoid polling in _process.
2. 2Subtle Cues - Secrets should be hinted at, not invisible.
3. 3Global Persistence - Use separate save files for meta-progress.

What it can do on your machine

Read from SKILL.md and the folder at commit 4c4d0ff. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 13 files in scripts/, which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • docs.godotengine.org

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Godot Mechanic Secrets loads about 3.2k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 130 tokens; SKILL.md has 866 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~130

When it runs · the whole SKILL.md, loaded when a task matches

~3.2k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from thedivergentai/GD-Agentic-Skills at commit 4c4d0ff, republished under its LGPL-3.0 licence (© thedivergentai). 866 words, ~3,234 tokens.

name

godot-mechanic-secrets

description

Implement cheat codes, hidden interactions, and unlockable meta-content via time-windowed input sequence buffers, spam thresholds, look-at (dot-product) detectors, progress-% unlocks, and meta persistence in user://secrets.cfg. Use when adding Konami-style codes, curiosity spam eggs, glimmer cues, lockout anti-brute-force, or gallery flags that must survive slot deletes. Keywords: Konami, sequence buffer, meta secrets.cfg, visibility detector, lockout, glimmer, spam threshold, progress unlock.

# Attach SecretSequenceComboMatcher (class_name) as a child of GameManager / Player
@onready var combo: SecretSequenceComboMatcher = $SecretSequenceComboMatcher

func _ready() -> void:
    # Default sequences Dictionary already includes "Konami"; override or add:
    combo.sequences = {
        "GodMode": ["ui_up", "ui_up", "ui_down", "ui_down", "ui_left", "ui_right", "ui_left", "ui_right"]
    }
    combo.combo_achieved.connect(_on_cheat_unlocked)

func _on_cheat_unlocked(combo_name: String) -> void:
    print("Unlocked: ", combo_name)
    # Meta flag — NOT the per-slot SaveManager payload
    SecretMetaPersistence.unlock_secret("god_mode")  # via secret_meta_persistence.gd API

© thedivergentai, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files (scripts, references) in skills/godot-mechanic-secrets of thedivergentai/GD-Agentic-Skills.

• SKILL.md
• references/migration-notes.md
• references/secrets-meta-patterns.md
• scripts/input_sequence_watcher.gd
• scripts/interaction_threshold_trigger.gd
• scripts/secret_audio_environment_occluder.gd
• scripts/secret_interaction_spam_tracker.gd
• scripts/secret_konami_legacy_code.gd
• scripts/secret_lockout_cheat_guard.gd
• scripts/secret_meta_persistence.gd
• scripts/secret_persistence_handler.gd
• scripts/secret_progress_threshold_unlocker.gd
• scripts/secret_random_encounter_spawner.gd
• scripts/secret_sequence_combo_matcher.gd
• scripts/secret_vfx_discovery_glimmer.gd
• scripts/secret_visibility_detector.gd

Open the folder on GitHubat commit 4c4d0ff