Agent skill

Godot Dialogue System

by thedivergentai in thedivergentai/GD-Agentic-Skills

Expert patterns for branching dialogue systems including dialogue graphs (Resource-based), character portraits, player choices, conditional dialogue (flags/quests), typewriter effects, localization…

LGPL-3.0Auto-check passedGame Development

Install Godot Dialogue System

skills CLI
$ npx skills add thedivergentai/GD-Agentic-Skills --skill godot-dialogue-system -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thedivergentai/GD-Agentic-Skills godot-dialogue-system --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thedivergentai/GD-Agentic-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/godot-dialogue-system .claude/skills/godot-dialogue-system && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
godot-dialogue-system
GitHub stars
821
Token cost
~3k tokens
SKILL.md length
853 words
Files
18 (incl. scripts, references)
Skills in repo
98
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Expert patterns for branching dialogue systems including dialogue graphs (Resource-based), character portraits, player choices, conditional dialogue (flags/quests), typewriter effects, localization…

  • Narrative games
  • SKILL.md covers NEVER Do in Dialogue Systems, Decision Tree: Authoring Engine, Available Scripts (single… and Typewriter Contract (skip-safe), plus 2 more sections
  • Keywords: DialogueLine
  • Dialoguemanager

What it does

Godot Dialogue System is an agent skill from thedivergentai/GD-Agentic-Skills. Expert patterns for branching dialogue systems including dialogue graphs (Resource-based), character portraits, player choices, conditional dialogue (flags/quests), typewriter effects, localization support, and voice acting integration. Use for narrative games, RPGs, or visual novels. Trigger keywords: DialogueLine, DialogueChoice, DialogueGraph, dialoguemanager, typewritereffect, branchingdialogue, dialogueflags, localization, voiceacting.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts and reference files (for example `references/elite-dialogue-patterns.md` and `references/migration-notes.md`).

It sits in Game Development, covering Game development, Internationalization and Creative writing and fiction. It works with Godot. The repository describes itself as: The official "Long-Term Memory" for Godot 4.7+ AI Agents. A high-density library of 99 expert skills and 27 genre blueprints, providing audited, strictly typed GDScript patterns… The licence is LGPL-3.0.

When your agent uses it

  • Narrative games
  • Keywords: DialogueLine
  • Dialoguemanager
  • Typewritereffect

Example prompts

  • “/godot-dialogue-system”

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 15 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 Dialogue System loads about 3k tokens when it runs, and up to ~4.4k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 853 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~118
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.4k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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). 853 words, ~2,972 tokens.

Download SKILL.mdSave it as .claude/skills/godot-dialogue-system/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
godot-dialogue-system
description
Expert patterns for branching dialogue systems including dialogue graphs (Resource-based), character portraits, player choices, conditional dialogue (flags/quests), typewriter effects, localization support, and voice acting integration. Use for narrative games, RPGs, or visual novels. Trigger keywords: DialogueLine, DialogueChoice, DialogueGraph, dialogue_manager, typewriter_effect, branching_dialogue, dialogue_flags, localization, voice_acting.

Dialogue System

Data-driven dialogue routing — not beginner typewriter tutorials.

NEVER Do in Dialogue Systems

  • NEVER hardcode dialogue text in GDScript — Store lines in Resources / JSON / CSV so localization works.
  • NEVER show choices the player has not unlocked — Hide (or intentionally gray) gated options.
  • NEVER use unvalidated loose strings for node transitions — Typos in next_node_id soft-lock mid-convo; assert / registry IDs.
  • NEVER force a typewriter without skip — Click/confirm must finish the line immediately.
  • NEVER drive reveal with per-character Timer / OS.delay_msec() — Use visible_ratio / visible_characters + Tween (see typebox_effect.gd).
  • NEVER store dialogue cursor state only in the UI node — Scene changes drop the player; keep progress in the manager Autoload / session object.
  • NEVER get_node() from NPCs into Dialogue UI — Start via manager signals (start_dialogue(res)).
  • NEVER invent regex for BBCode — Prefer RichTextLabel BBCode / custom effects.
  • NEVER save/load inside a dialogue node Resource — Nodes are data; persistence belongs to SaveSystem.
  • NEVER hardcode portrait paths in code — Assign textures on node Resources or a portrait database.

Decision Tree: Authoring Engine

Authoring needEngineMANDATORY scriptsDo NOT Load
Designer-friendly .tres graphs in-repoResource Autoload graphdialogue_resource.gd → dialogue_manager_singleton.gd → dialogue_ui_controller.gd → typebox_effect.gddialogue_engine.gd JSON path
External writers / spreadsheet → JSONJSON graph enginedialogue_engine.gd (+ optional dialogue_manager.gd) → UI + typeboxResource Autoload stack
Visual node editor in-projectGraphEdit authoringKeep runtime on Resource or JSON export; GraphEdit is editor-only toolingShipping GraphEdit as the runtime walker
Conditions / quest gatesEitherbranching_condition_validator.gdEmbedding flag checks in UI buttons
Portraits / expressionsEitherdialogue_portrait_manager.gd—
Localization keysEitherlocalized_dialogue_resource.gdHardcoded language if trees
Quest / gameplay hooks from linesEitherdialogue_event_bridge.gdSide effects inside UI controller

Default golden path: Resource Autoload → UI controller → typebox_effect. Pick one runtime engine; do not run Resource manager and JSON engine in parallel.

Available Scripts (single catalog)

Runtime (golden path)
Supporting
Alternate engines (load only if decision tree says so)

Typewriter Contract (skip-safe)

Use typebox_effect.gd: set full text, tween visible_ratio (or RichTextLabel visible_characters) from 0→1. On skip input: kill tween and snap visibility to complete. Do not spawn a Timer per character.

Elite Deltas

MANDATORY for GraphEdit tooling, TTS/lipsync, analytics, and moved inline manager/UI tutorials: elite-dialogue-patterns.md. Do NOT Load for Resource Autoload golden path only.

Reference

Progressive disclosure: open Official Documentation links only when researching a specific API; load Related Skills when routing to a peer domain — do not preload the whole lattice.

Show full SKILL.md (382 more words)Show less
Official Documentation
  • Resources — Why dialogue graphs belong in Resource / .tres data instead of hardcoded strings in scripts.
  • BBCode in RichTextLabel — Native markup for speaker emphasis, custom tags, and effects without rolling your own parser.
  • RichTextLabel — visible_characters / image helpers and BBCode APIs the dialogue UI should drive for typewriter and portraits.
  • Internationalizing games — tr() / TranslationServer workflow so line text stays key-based across locales.
  • Localization using spreadsheets — CSV translation tables that map cleanly onto dialogue text_key fields.
  • Importing translations — How Godot imports CSV/PO so localized dialogue resources resolve at runtime.
  • Using signals — Emit line/choice/end events upward so UI, quests, and audio never hard-reference the manager internals.
  • Singletons (Autoload) — Register a DialogueManager that survives scene changes and owns traversal state.
  • Tween — Drive visible_ratio / character reveal timing without blocking the main thread.
  • Text-to-speech — DisplayServer TTS callbacks for placeholder VO and lipsync-adjacent timing.
  • GraphEdit — Editor surface for authoring branching dialogue graphs when .tres lists become unwieldy.
  • JSON — Parse external dialogue graph files when designers prefer JSON over Resources.
Prerequisites
  • godot-project-foundations — Autoload registration, input for advance/skip, and project layout dialogue UI scenes plug into.
  • godot-gdscript-mastery — Typed Resources, signals, await, and Callables required before branching engines and UI bridges.
  • godot-resource-data-patterns — Canonical patterns for DialogueLine / graph Resources, exports, and avoiding duplicated mutable state.
  • godot-autoload-architecture — Singleton ownership and boot order for a global DialogueManager that must outlive scene swaps.
Complements
  • godot-signal-architecture — Signal-up / call-down contracts for line_displayed, choice selection, and narrative event bridges.
  • godot-ui-rich-text — RichTextLabel BBCode, custom effects, and image embedding beyond the basics used in typewriter UIs.
  • godot-ui-containers — Layout choice buttons and dialogue panels without fighting Control sizing and focus.
  • godot-tweening — Skip-safe Tweens for character reveal, portrait entry, and panel transitions.
  • godot-audio-systems — Voice-line players, bus ducking during dialogue, and subtitle sync with spoken audio.
  • godot-quest-system — Quest flags and objectives that gate conditional choices and fire from dialogue event bridges.
  • godot-save-load-systems — Persist dialogue flags / seen-node state outside UI nodes so progress survives reloads.
Downstream / consumers
  • godot-genre-visual-novel — Full VN presentation loops consume this skill’s graph traversal, portraits, and choice UI patterns.
  • godot-inventory-system — Dialogue effects often grant/require items; keep grant logic in inventory, not inside line Resources.
  • godot-monte-carlo-balancer — Simulate skill-check / branching choice trees when narrative gates or reward paths need balance passes.
Master
  • godot-master — Library router and mirrored module entry; open when discovering which Domain Skill owns narrative, UI, or quest concerns.

© 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 17 other files (scripts, references) in skills/godot-dialogue-system of thedivergentai/GD-Agentic-Skills.

  • SKILL.md
  • references/elite-dialogue-patterns.md
  • references/migration-notes.md
  • scripts/branching_condition_validator.gd
  • scripts/dialogue_engine.gd
  • scripts/dialogue_event_bridge.gd
  • scripts/dialogue_graph_editor.gd
  • scripts/dialogue_lipsync.gd
  • scripts/dialogue_manager.gd
  • scripts/dialogue_manager_singleton.gd
  • scripts/dialogue_node_data.gd
  • scripts/dialogue_option_data.gd
  • scripts/dialogue_portrait_manager.gd
  • scripts/dialogue_resource.gd
  • scripts/dialogue_stat_logger.gd
  • scripts/dialogue_ui_controller.gd
  • scripts/localized_dialogue_resource.gd
  • scripts/typebox_effect.gd

Open the folder on GitHubat commit 4c4d0ff

Compare with similar skills

Godot Dialogue System next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Godot Dialogue System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godot Dialogue System this skillthedivergentai/GD-Agentic-Skills821—~3kAutomated safety check: PassLGPL-3.0
Konado Scriptgodothub/konado125—~247Automated safety check: PassMIT
Localizationjame581/GodotPrompter805—~3.2kAutomated safety check: PassMIT
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
2D Map and Scene Generator0x0funky/agent-sprite-forge4.4k—~2.9kAutomated safety check: PassMIT
Godot UI Integrationzimo-xiao-zheng/godot-ui-integration285—~1.5kAutomated safety check: PassMIT

Similar skills

  • Konado Script

    godothub/konado

    视觉小说引擎 Konado DSL (.ks) 的编辑器增强技能包,提供语法高亮、代码补全、静态诊断和代码格式化参考配置。

    125 GitHub stars~247 tokensUpdated 29 days ago
    Game DevelopmentAuto-check passed
  • Localization

    jame581/GodotPrompter

    A skill your agent uses when implementing localization (i18n/l10n) — TranslationServer, CSV/PO translation files, locale switching, RTL support, and pluralization in Godot 4.3+

    805 GitHub stars~3.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Godot Gdscript Patterns

    925236118/AlphaAgent

    Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.

    103 GitHub starsUsed in 10 repos~5k tokens
    Game DevelopmentAuto-check passed
  • 2D Map and Scene Generator

    0x0funky/agent-sprite-forge

    Plans and builds 2D game maps and scenes, from tilemaps and parallax backgrounds to HD-2D plates, with collision checks, a playable HTML preview and Tiled, Godot or LDtk export.

    4.4k GitHub stars~2.9k tokensUpdated 4 days ago
    Game DevelopmentAuto-check passed
  • Godot UI Integration

    zimo-xiao-zheng/godot-ui-integration

    Build or revise Godot UI from an approved design, separated art, or a visual reference when scene structure, gameplay binding, and runtime visual verification all matter.

    285 GitHub stars~1.5k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Godot Wechat Minigame Adapter

    godothub/godot-minigame

    Apply the bundled self-contained Godot WeChat Mini Game adapter kit to an official Godot checkout.

    187 GitHub stars~1.5k tokensUpdated 25 days ago
    Game DevelopmentAuto-check passed

More from thedivergentai/GD-Agentic-Skills

All 98 skills in this repo
  • Godot 2D Animation

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 2D animation in Godot using AnimatedSprite2D and skeletal cutout rigs.

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot 3D World Building

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 3D level design using GridMap with MeshLibrary, CSG constructive solid geometry, occlusion, and runtime GridMap builders.

    821 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 2D To 3D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for migrating 2D games to 3D including node type conversions, camera systems (third-person, first-person, orbit), physics layer migration, sprite-to-model art pipeline, and control…

    821 GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 3D To 2D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for simplifying 3D games to 2D including dimension reduction strategies, 2.5D fake-depth, isometric ports, camera flattening, physics conversion, 3D-to-sprite art pipeline, and…

    821 GitHub stars~4.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Agent Vision

    thedivergentai/GD-Agentic-Skills

    Agentic eyes for Godot work: cross-platform screenshot CLI (asset/region/window/screen) to budgeted WebP, TEMP editor viewport bridge under .gdskills/, and Taste Receptor Atlas v2 (~237…

    821 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Animation Tree Mastery

    thedivergentai/GD-Agentic-Skills

    Expert patterns for AnimationTree including StateMachine transitions, BlendSpace2D for directional movement, BlendTree for layered animations, root motion, transition conditions, advance…

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Godot Dialogue System

What does Godot Dialogue System do?

Expert patterns for branching dialogue systems including dialogue graphs (Resource-based), character portraits, player choices, conditional dialogue (flags/quests), typewriter effects, localization…. Godot Dialogue System is an agent skill from thedivergentai/GD-Agentic-Skills. Expert patterns for branching dialogue systems including dialogue graphs (Resource-based), character portraits, player choices, conditional dialogue (flags/quests), typewriter effects, localization support, and voice acting integration.

When should I use Godot Dialogue System?

Godot Dialogue System fits situations like: narrative games; keywords: DialogueLine; dialoguemanager; typewritereffect.

How do I install Godot Dialogue System in Claude Code?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-dialogue-system -a claude-code`. Or copy the skill folder (skills/godot-dialogue-system in thedivergentai/GD-Agentic-Skills) into .claude/skills/godot-dialogue-system in your project. Claude Code loads it when a task matches its description.

How do I install Godot Dialogue System in Codex?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-dialogue-system -a codex`. Or copy the skill folder (skills/godot-dialogue-system in thedivergentai/GD-Agentic-Skills) into .agents/skills/godot-dialogue-system in your project. Codex loads it when a task matches its description.

Can I use Godot Dialogue System in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-dialogue-system -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/godot-dialogue-system, .gemini/skills/godot-dialogue-system, .github/skills/godot-dialogue-system and .opencode/skills/godot-dialogue-system in your project.

What does Godot Dialogue System need to run?

SKILL.md names no scripts, command-line tools or credentials: Godot Dialogue System is instructions for the agent only.

Does Godot Dialogue System access the network?

SKILL.md names 1 domain. As links in the text: docs.godotengine.org. This is read from the text; nothing was executed.

Is Godot Dialogue System safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Godot Dialogue System use?

Godot Dialogue System is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Godot Dialogue System use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Godot Dialogue System?

Skills that share tags, products or a category with Godot Dialogue System: Konado Script (godothub/konado, 125 stars), Localization (jame581/GodotPrompter, 805 stars), Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars) and 2D Map and Scene Generator (0x0funky/agent-sprite-forge, 4.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Godot Dialogue System?

thedivergentai (a GitHub user) maintains it in thedivergentai/GD-Agentic-Skills, which has 821 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 9, 2026.

Source: thedivergentai/GD-Agentic-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.