{
  "markdown": "# Godot Skill\n\nAn AI agent skill that transforms coding assistants into expert Godot 4.3+ game development assistants. Generates production-ready GDScript 2.0 with strict static typing, official style guide compliance, and modern architecture patterns.\n\nWorks with **Claude Code, Cursor, Windsurf, Cline, Copilot, Codex, Gemini CLI, opencode, Amp, Goose, Kiro, and OpenClaw**.\n\n## What It Does\n\n- Writes **GDScript 2.0 only** — actively prevents Godot 3 syntax, deprecated APIs, and common AI hallucinations\n- Enforces **strict static typing** on every variable, parameter, and return type\n- Follows the **official GDScript style guide** — naming conventions, code ordering (17-step rule), formatting\n- Applies **modern architecture patterns** — signals (\"call down, signal up\"), composition over inheritance, data-driven Resources, state machines\n- Knows **TileMapLayer** (not deprecated TileMap), **FileAccess/DirAccess** (not File/Directory), modern tweens, Callable-based signal connections\n- Outputs **code blocks only** with minimal architectural rationale — no filler\n\n## Installation\n\n### Quick Install (all agents)\n\n```bash\nbash install.sh\n```\n\nThis installs the skill to all supported agent paths at once.\n\n### Claude Code Plugin Marketplace\n\n```bash\nnpx add-skill shihabshahrier/Godot-Skill\n```\n\n### Manual Installation (per agent)\n\n```bash\n# Claude Code\nmkdir -p ~/.claude/skills/godot\ncp -r skills/godot/. ~/.claude/skills/godot/\n\n# Codex / Amp / Goose / Kiro\nmkdir -p ~/.agents/skills/godot\ncp -r skills/godot/. ~/.agents/skills/godot/\n\n# opencode\nmkdir -p ~/.config/opencode/skills/godot\ncp -r skills/godot/. ~/.config/opencode/skills/godot/\n\n# Gemini CLI\nmkdir -p ~/.gemini/antigravity/skills/godot\ncp -r skills/godot/. ~/.gemini/antigravity/skills/godot/\n\n# OpenClaw\nmkdir -p ~/.openclaw/workspace/skills/godot\ncp -r skills/godot/. ~/.openclaw/workspace/skills/godot/\n```\n\n### Cursor / Windsurf / Cline / Copilot\n\nClone this repo into your project or copy the relevant config files:\n\n| Agent | Config file | Auto-loaded |\n|-------|------------|-------------|\n| Cursor | `.cursor/rules/godot.mdc` | When Godot tasks detected |\n| Windsurf | `.windsurf/rules/godot.md` | Manual trigger |\n| Cline | `.clinerules/godot.md` | Always injected |\n| Copilot | `.github/copilot-instructions.md` | Always injected |\n\n## Agent Support\n\n| Agent | How it loads the skill | Config files |\n|-------|----------------------|--------------|\n| Claude Code | Plugin system (`skills/godot/SKILL.md`) | `plugin.json`, `marketplace.json` |\n| Cursor | Rules + skills directory | `.cursor/rules/godot.mdc`, `.cursor/skills/godot/` |\n| Windsurf | Rules + skills directory | `.windsurf/rules/godot.md`, `.windsurf/skills/godot/` |\n| Cline | Auto-injected rules | `.clinerules/godot.md` |\n| GitHub Copilot | Repo-wide instructions | `.github/copilot-instructions.md` |\n| OpenAI Codex | Hooks + AGENTS.md | `.codex/`, `agents/openai.yaml`, `AGENTS.md` |\n| Gemini CLI | Extension + context file | `gemini-extension.json`, `GEMINI.md` |\n| opencode (SST) | AGENTS.md / CLAUDE.md | `AGENTS.md`, `CLAUDE.md` |\n| Amp / Goose / Kiro | Skills directory | `~/.agents/skills/godot/` via `install.sh` |\n| OpenClaw | Skills directory | `~/.openclaw/workspace/skills/godot/` via `install.sh` |\n\n## Repo Structure\n\n```\nGodot-Skill/\n├── skills/godot/\n│   ├── SKILL.md                         # Main skill (source of truth)\n│   └── references/\n│       ├── gdscript-style-guide.md      # Naming, formatting, 17-step ordering\n│       ├── godot4-syntax.md             # Deprecation map, migration patterns\n│       ├── architecture-patterns.md     # Signals, state machines, composition\n│       └── common-systems.md            # TileMapLayer, FileAccess, Resources, UI\n├── .claude-plugin/\n│   ├── plugin.json                      # Claude Code plugin metadata\n│   └── marketplace.json                 # Marketplace listing\n├── .cursor/\n│   ├── rules/godot.mdc                  # Cursor rule (condensed)\n│   └── skills/godot/                    # Cursor skills copy\n├── .windsurf/\n│   ├── rules/godot.md                   # Windsurf rule (condensed)\n│   └── skills/godot/                    # Windsurf skills copy\n├── .clinerules/godot.md                 # Cline rule (condensed)\n├── .github/copilot-instructions.md      # Copilot instructions (condensed)\n├── .codex/\n│   ├── config.toml                      # Codex feature flags\n│   └── hooks.json                       # Codex session hooks\n├── agents/openai.yaml                   # Codex display config\n├── AGENTS.md                            # Codex / opencode / Amp / Goose include\n├── CLAUDE.md                            # Claude Code / opencode project context\n├── GEMINI.md                            # Gemini CLI include\n├── gemini-extension.json                # Gemini CLI extension config\n├── install.sh                           # Universal installer (all agents)\n└── README.md\n```\n\n## What It Prevents\n\n| Common AI Mistake | This Skill Enforces |\n|---|---|\n| `yield(obj, \"signal\")` | `await obj.signal` |\n| `emit_signal(\"name\")` | `signal_name.emit()` |\n| String-based `connect()` | Callable-based connections |\n| `TileMap` node | `TileMapLayer` node |\n| `File` / `Directory` classes | `FileAccess` / `DirAccess` |\n| Dynamic typing | Strict static typing with `:=` and `-> Type` |\n| `deg2rad` / `rand_range` etc. | `deg_to_rad` / `randf_range` etc. |\n| camelCase / Hungarian notation | Official snake_case / PascalCase conventions |\n| God objects / tight coupling | Composition, signals, Resource separation |\n| Autoload overuse | Static classes when no node lifecycle needed |\n\n## Triggers\n\nThe skill activates when you mention anything related to Godot development:\n\n- \"Create a Godot game\"\n- \"Write a player controller in GDScript\"\n- \"Build a state machine for enemy AI\"\n- \"Set up a save/load system\"\n- \"Make a 2D platformer\"\n- \"Implement tilemaps\"\n- Or any mention of Godot nodes, GDScript, or game mechanics\n\n## Architecture Decisions\n\n**SKILL.md under 500 lines** — core rules stay lean. Heavy reference material lives in `references/` and loads on demand.\n\n**4 reference files** covering the complete Godot 4.3+ surface area:\n1. **Style Guide** — naming/formatting/ordering rules\n2. **Syntax** — complete Godot 3→4 deprecation map\n3. **Architecture** — signals, state machines, composition, entity pattern\n4. **Common Systems** — TileMapLayer, FileAccess, Resources, input, camera, UI\n\n**Multi-agent by design** — same SKILL.md content adapted per agent's config format. Source of truth is always `skills/godot/SKILL.md`.\n\n## License\n\nMIT\n\n---\n\n📖 **Project page:** https://shihub.online/projects/godot-skill\n",
  "bytes": 6650,
  "sha": "a4db700cb522d404a50d55bbe46967f8407def8cb4c3d9fdfb44d93248a20e3f",
  "repo_slug": "shihabshahrier/godot-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_shihabshahrier_godot_skill_08eb1d1f/readme"
}