godot-skills

DEPRECATED - Skill now lives in the Randroid's Dojo marketplace

---

---

---

Godot-Claude-Skills

A Claude Code skill for Godot Engine game development.

What are Skills?

Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Each skill contains a SKILL.md file with YAML frontmatter and markdown instructions.

Repository Structure

.
├── .claude-plugin/
│   ├── plugin.json            # Plugin metadata for marketplace
│   └── marketplace.json       # Marketplace registry info
├── .github/
│   └── workflows/
│       └── ci.yml             # GitHub Actions CI workflow
├── example-project/           # Tic-Tac-Toe game for testing
│   ├── project.godot
│   ├── test/                  # GdUnit4 test files
│   ├── scenes/
│   └── scripts/
├── skills/
│   └── godot/                 # Godot development skill
│       ├── SKILL.md
│       ├── scripts/           # Python helper scripts
│       └── references/        # Documentation
├── LICENSE                    # MIT License
├── CHANGELOG.md               # Version history
└── README.md

Godot Skill

Develop, test, build, and deploy Godot 4.x games. Includes:

• GdUnit4 integration - Unit tests, scene tests, input simulation
• PlayGodot automation - Game automation framework for E2E testing (like Playwright for games)
• Web/Desktop exports - Build and export games
• CI/CD pipelines - GitHub Actions workflows
• Deployment - Vercel, GitHub Pages, itch.io
• Python helper scripts - run_tests.py, parse_results.py, export_build.py

Quick Example

# test/game_test.gd
extends GdUnitTestSuite

func test_player_health() -> void:
    var player = auto_free(Player.new())
    assert_that(player.health).is_equal(100)

    player.take_damage(30)
    assert_that(player.health).is_equal(70)

Running Tests

# Run all tests with GdUnit4
godot --headless --path . -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd --run-tests

# Using helper script
python skills/godot/scripts/run_tests.py --project ./my-game

PlayGodot Game Automation

PlayGodot is a game automation framework for Godot - like Playwright, but for games. Control games from Python, write E2E tests, capture screenshots, and simulate input via Godot's native debugger protocol.

Requirements:

• Custom Godot fork with automation support: Randroids-Dojo/godot (automation branch)
• PlayGodot Python library:

  python -m venv .venv
  source .venv/bin/activate  # Windows: .venv\Scripts\activate
  pip install playgodot
  

import pytest
from playgodot import Godot

@pytest.mark.asyncio
async def test_game_state():
    async with Godot.launch("./my-game", headless=True) as game:
        await game.wait_for_node("/root/Game")

        # Call game methods
        result = await game.call_method("/root/Game", "get_score")
        assert result == 0

        # Get/set properties
        health = await game.get_property("/root/Game/Player", "health")
        await game.set_property("/root/Game/Player", "health", 100)

        # Simulate input
        await game.click(400, 300)
        await game.press_key(KEY_SPACE)
        await game.press_action("jump")

        # Screenshots
        await game.screenshot("test_screenshot.png")

# Run PlayGodot tests
pytest tests/ -v

Building & Deploying

# Export web build
godot --headless --export-release "Web" ./build/index.html

# Deploy to Vercel
vercel deploy ./build --prod

Vercel Deployment Setup

To enable automatic Vercel deployment from GitHub Actions:

1. Install Vercel CLI and link project:

   npm i -g vercel
   vercel link
   

2. Add GitHub repository secrets (Settings → Secrets → Actions):

   • VERCEL_TOKEN - Get from vercel.com/account/tokens
   • VERCEL_ORG_ID - From .vercel/project.json
   • VERCEL_PROJECT_ID - From .vercel/project.json

3. Add GitHub repository variable:

   • ENABLE_VERCEL_DEPLOY = true

See deployment.md for detailed instructions.

Example Project

The repository includes a Tic-Tac-Toe game (example-project/) with full test coverage:

• 2-player game with X and O turns
• Win detection for rows, columns, and diagonals
• Draw detection when board is full
• GdUnit4 tests - Unit and integration tests
• PlayGodot automation - E2E tests via game automation framework
• Web export - Deployable to Vercel

Running Locally

# Open in Godot Editor
godot --path example-project --editor

# Run headless (for testing)
godot --headless --path example-project --quit