kitao

Pyxel Skill — Development skill for Claude Code

Development community

Claude Code skill for retro game development with Pyxel.

How to install Pyxel Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kitao/pyxel-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Pyxel Skill does

Claude Code skill for retro game development with Pyxel.

Alternatives in Development

Vampire The Masquerade Lore Expert — /role_play "ChatGPT Game Master" 9.1k ★
Retro — Facilitate structured sprint retrospectives with action items 7.8k ★
Godogen Source Repo — This repository contains two source trees for the same project: - claude/ — Claude Code source tree - codex/ 2.8k ★

README

pyxel-skill

[![Tests](https://img.shields.io/github/actions/workflow/status/kitao/pyxel-skill/test.yml?branch=main&label=tests)](https://github.com/kitao/pyxel-skill/actions/workflows/test.yml) [![Agent Skills](https://img.shields.io/badge/Agent_Skills-spec_compliant-blue)](https://agentskills.io/specification) [![License](https://img.shields.io/github/license/kitao/pyxel-skill)](LICENSE)

An [Agent Skill](https://agentskills.io) for building and verifying [Pyxel](https://github.com/kitao/pyxel) games. It guides implementation and verification for the requested game; [pyxel-mcp](https://github.com/kitao/pyxel-mcp) supplies the observation tools it drives.

Version 1.4.2 targets pyxel-mcp >= 1.3.1, Pyxel >= 2.9.6, and Python >= 3.11.

Install

Claude Code

The repository is also a plugin that bundles the pyxel-mcp server configuration:

claude plugin marketplace add kitao/pyxel-skill
claude plugin install pyxel@pyxel-skill

The plugin registers the `pyxel` MCP server as `uvx --from 'pyxel-mcp>=1.3.1' pyxel-mcp`, so do not add the server again by hand. The skill is available as `/pyxel:pyxel` and activates on its own for Pyxel work.

Any agent with the skills CLI

Add the skill:

npx skills add kitao/pyxel-skill

For clients without automatic plugin registration, also follow [MCP setup](#mcp-setup). Claude Code recognizes this skill's plugin manifest and registers the bundled server; for a project install, trust the workspace and enable the server when prompted.

Manual

The installed folder or symlink must be named `pyxel`.

git clone https://github.com/kitao/pyxel-skill.git .claude/skills/pyxel
rm -rf .claude/skills/pyxel/.git

For a shared local clone:

git clone https://github.com/kitao/pyxel-skill.git ~/src/pyxel-skill

# Agent Skills
mkdir -p ~/.agents/skills && ln -s ~/src/pyxel-skill ~/.agents/skills/pyxel

# Codex
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills" && ln -s ~/src/pyxel-skill "${CODEX_HOM