playables-youtube-sdk

About this project

The Playables Agent SDK is a meta-framework for building YouTube Playables mini-games using web technologies (JavaScript/HTML) with Phaser 3 as the default engine. It's designed to be operated by AI coding agents (like Claude Code or Codex) through the `AGENTS.md` contract, which defines the behavior and skills for automated game development. Key features include pre-built templates for different game types (puzzle, runner, idle), core libraries for common game mechanics (input handling, object pooling, state management), and utilities for performance monitoring, accessibility, and localization. The SDK provides a reference game ("Meteor Dodger") that demonstrates all systems in action, along with a Vite-based development environment for quick iteration. To get started, developers can create a new game using the provided script with a chosen template, then install dependencies and run the development server. The project structure includes skill-based modules for different aspects of game development, making it easy to extend or replace components. While Phaser 3 is the default engine, the architecture supports other engines through additional skills. The SDK focuses on the game development workflow but doesn't handle YouTube Playables portal access, which requires manual setup through Google's developer program.

This is a GitHub repository (source code), not a hosted HTTP API endpoint.

From the docs

Snippets taken from the repository README when available.

# Crear un juego nuevo a partir de un template
node scripts/new-game.mjs --name mi-juego --title "Mi Juego" \
  --description "Un puzzle rápido de 30 segundos" \
  --template phaser-starter   # o: puzzle-starter | runner-starter | idle-starter

cd games/mi-juego
npm install
npm run dev           # http://localhost:8080
npm run agent-check   # typecheck + lint + validate + build, todo en uno