pyxel-skill

A Claude Code skill for building retro games with Pyxel.

What is this?

This skill teaches Claude Code how to create retro-style games using the Pyxel game engine. It works together with pyxel-mcp, an MCP server that provides visual verification, audio rendering, and debugging tools.

Prerequisites

Install the pyxel-mcp MCP server. The easiest way is to ask Claude Code to create a Pyxel game — it will automatically discover and set up pyxel-mcp from the MCP Registry.

For manual setup, add to your MCP configuration:

{
  "mcpServers": {
    "pyxel": {
      "command": "uvx",
      "args": ["pyxel-mcp"]
    }
  }
}

Installation

Copy or symlink SKILL.md into your Claude Code skills directory:

# Option 1: Symlink (auto-updates with git pull)
ln -s /path/to/pyxel-skill/SKILL.md ~/.claude/skills/pyxel.md

# Option 2: Copy
cp /path/to/pyxel-skill/SKILL.md ~/.claude/skills/pyxel.md

Usage

Once installed, Claude Code will automatically activate this skill when you ask it to create Pyxel games. For example:

• "Make a simple shooting game with Pyxel"
• "Create a retro platformer"
• "Build an 8-bit puzzle game with chiptune music"

Links

• Pyxel — The retro game engine
• pyxel-mcp — MCP server for AI-assisted Pyxel development
• anthropics/skills — Claude Code community skills collection

License

MIT