Parrot Cart developersGet a Parrot Cart

The Claude skill

The starter kit comes with a skill for Claude Code. It tells Claude how the SDK works and what the cart needs from a plugin, so Claude can help you write, port, test and release one.

Using it

Open your plugin’s folder in Claude Code and ask for what you want, such as “make a paddle game” or “port this arcade game”. Claude Code finds the skill in the folder and uses it for work on a Parrot Cart plugin.

Claude builds the plugin, runs it in the simulator, looks at the picture and fixes what it finds. Claude can’t try a plugin on a console, so before a release it asks you to. Tagging and pushing a release happen only when you ask.

Every new plugin has it

tools/new-plugin.py copies the kit, skill included, into the new plugin’s folder, so the skill is already there in .claude/skills/parrot-cart-plugin.

What’s in it

FileWhat it has
SKILL.mdHow a plugin works, choosing between Lua, the screen kernel and the frame kernel, getting set up, the build and check loop with the simulator, the rules the cart depends on, and releasing.
references/sdk-api.mdThe SDK’s calls by area, with the header each one is in.
references/porting.mdPorting a game: the published plugins as examples, budgets and timing, the picture, sound and how loud, arcade games, memory, testing and licenses.
scripts/check-tools.shChecks the build tools and says how to install the ones that are missing.
scripts/check-release.pyChecks a plugin before a release: its ID, the version against the tag, the README’s credits and source link, screenshots, licenses, timing, and game files that must not be in the repository.

Using it somewhere else

To use the skill in Claude Code outside a copy of the kit, put its folder in ~/.claude/skills/. The zip has the same folder.

The skill is the folder .claude/skills/parrot-cart-plugin in the starter kit.