/godot-api

name: godot-api
description: |
  Look up Godot engine class APIs — methods, properties, signals, enums.
  Use when you need to find which class to use or look up specific API details.
  Supports version-specific docs — reads the correct API for the project's Godot version.

Godot API Lookup

$ARGUMENTS

<!-- agent-operations: read_skill_reference, run_shell_command -->

Skill-local paths

Resolve every bundled path below relative to this skill's published directory, using the active runtime's `read_skill_reference` mapping. Call that resolved directory `<godot-api-skill-dir>`; do not assume a runtime-specific skill-root environment variable.

Version detection

Docs are stored per Godot version under `doc_api/{version}/` and `doc_api_csharp/{version}/`.

Determine the version to use: 1. If the caller specifies a version (e.g. "4.4"), use that 2. If `project.godot` exists in the working directory, extract from `config/features` 3. Otherwise fall back to `latest`

Bootstrap if docs for the target version are missing:

bash "<godot-api-skill-dir>/tools/ensure_doc_api.sh" [version]

How to answer

**Language selection:** `doc_api/{version}/` contains GDScript docs. `doc_api_csharp/{version}/` contains C# docs. Default to GDScript unless the caller asks about C#.

1. Read `<godot-api-skill-dir>/doc_api/{version}/_common.md` — index of ~128 common classes

• For C#: `<godot-api-skill-dir>/doc_api_csharp/{version}/_common.md`

2. If the class isn't there, read `_other.md` in the same directory 3. Read `<godot-api-skill-dir>/doc_api/{version}/{ClassName}.md` for full API

• For C#: `<godot-api-skill-dir>/doc_api_csharp/{version}/{ClassName}.md`

4. Return what the caller needs:

• **Specific question** → relevant methods/signals with descriptions
• **Full API request** → the entire class doc

**C# syntax reference:** `<godot-api-skill-dir>/csharp.md` — C# Godot syntax, patterns, and recipes.

**GDScript syntax reference:** `<godot-api-skill-dir>/gdscript.md` — GDScript language spec, type system, patterns.