playdate-dev

Build and troubleshoot Playdate Lua games with input, graphics, and launcher metadata.

12|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/ckorhonen/claude-skills --skill playdate-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playdate-dev
Source: https://github.com/ckorhonen/claude-skills/tree/main/skills/playdate-dev
Command: npx skills add https://github.com/ckorhonen/claude-skills --skill playdate-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Guides Playdate Lua developers to build, debug, and optimize games for Playdate hardware and simulator, covering input, rendering, UI, and launcher workflow.

Core Features & Use Cases

  • Playdate-specific constraints and workflows for game development in Lua, including implementing the core loop, input handling (crank, buttons, accelerometer), graphics, UI, and metadata launcher with pdxinfo.
  • Design and accessibility guidelines references for Playdate UI, launcher assets, and performance considerations.
  • Use cases include prototyping simple games, debugging hardware interactions, and validating launcher metadata for a distributable build.

Quick Start

Copy the starter assets into a new Playdate project, configure Source/main.lua and pdxinfo, and begin implementing your Playdate game.

Frequently Asked Questions about playdate-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a starter project for Playdate game development in Lua?

Playdate input handling in Lua covers the crank, buttons, and accelerometer. You implement these interactions within your game's core loop using playdate.update, allowing direct hardware response for gameplay mechanics and UI navigation.

What is pdxinfo used for when building a Playdate game?

Pdxinfo is used to configure launcher metadata for a distributable Playdate build. It defines the game's title, developer, and other launcher assets, ensuring the game integrates correctly with the Playdate hardware UI and is ready for distribution.

Can I use this to troubleshoot hardware interactions for a Playdate simulator?

Yes, you can troubleshoot hardware interactions for the Playdate simulator. The Skill guides debugging and optimizing Lua code for input handling, graphics, and UI, validating performance and accessibility guidelines for both simulator and physical hardware.

Does Playdate development require specific design guidelines for UI and launcher assets?

Playdate development requires specific design guidelines for UI, launcher assets, and performance considerations. Following these references ensures the game meets accessibility standards and integrates smoothly with the hardware's unique display and input constraints.

What is the best way to structure a core loop in a Playdate Lua game?

The best way to structure a core loop in a Playdate Lua game is by implementing playdate.update. This function drives the game loop, integrating input handling, graphics rendering, and UI updates consistently across hardware and simulator environments.