The public playdrop plugin is the preferred way to bring PlayDrop creator workflows into Codex, Claude Code, and Cursor.
Canonical public source: playdrop-plugin.
Legacy compatibility surface: playdrop-skills and the legacy skill page.
Why Use the Plugin
- one public plugin with focused creator workflows
- routing through
task-routingwhen the right workflow is not obvious - shared references and assets for game creation, remixing, updates, reviews, listings, and worker tasks
- support for Codex, Claude Code, and Cursor from the same source repo
Specialist Skills
The plugin currently ships 13 skills from the sibling playdrop-plugin/skills directory:
| Skill | Purpose |
|---|---|
task-routing | Route PlayDrop requests to the smallest relevant builder v2 skill. |
create-game | Create a new PlayDrop game from a worker task or direct creator request. |
remix-game | Scaffold from a source app and transform it into a distinct game. |
update-game | Update an existing game without breaking current behavior. |
playtest-game | Self-playtest a game before upload or publish. |
review-game | Review a specific game version inside a GAME_REVIEW worker task. |
game-eval | Judge frozen game versions inside an internal GAME_EVAL task. |
discover-assets | Search PlayDrop for reusable games, assets, packs, and remix sources. |
make-assets | Choose, create, and declare gameplay assets. |
make-listing | Create listing assets and metadata that match the real game. |
market-game | Prepare lightweight marketing follow-up after the playable draft and listing are coherent. |
creator-help | Help creators with CLI, SDK, catalogue, upload, listing, and task issues. |
task-worker | Report progress, upload, complete, fail, and handle next steps inside worker task workspaces. |
If you are not sure which one to use, start with task-routing and let the plugin route the work.
Install the Plugin
Codex
Install or update the PlayDrop marketplace through the Codex CLI:
bash example
codex plugin marketplace add playdrop-ai/playdrop-plugin
codex plugin add playdrop@playdropRefresh the marketplace snapshot before reinstalling or verifying an update:
bash example
codex plugin marketplace upgrade playdrop
codex plugin add playdrop@playdrop
codex plugin listClaude Code
Either run these commands in Claude CLI directly, or tell the Claude app to run them with Claude CLI.
bash example
/plugin marketplace add playdrop-ai/playdrop-plugin
/plugin install playdrop@playdrop/plugin is not available inside the Claude Code app at the moment.
Cursor
Install the plugin from the Cursor marketplace or import the public repo as a team marketplace. For local testing, copy or symlink the repo into:
text example
~/.cursor/plugins/local/playdropThen restart Cursor or run Developer: Reload Window.
Recommended Workflow
After the plugin is installed, pair it with the CLI:
bash example
npm install -g @playdrop/playdrop-cli
playdrop auth login
playdrop auth whoami
playdrop documentation browseFor a new creator project:
bash example
playdrop project init .
playdrop project create app my-first-app --template playdrop/template/typescript_template
playdrop project dev my-first-app
playdrop project validate .Versioning
The public plugin manifests follow the PlayDrop platform release version. The private monorepo owns the sync command:
bash example
node scripts/set-public-plugin-version.mjs 0.11.5That command updates the Codex, Claude, and Cursor plugin manifests plus the version-bearing Claude and Cursor marketplace entries in the sibling playdrop-plugin repo.
Legacy Compatibility
The old umbrella playdrop skill is still supported for legacy skill-first environments and skills.sh installs, but it is no longer the preferred public setup.
Use the legacy skill only when your environment cannot install the plugin yet:
bash example
npx skills add https://github.com/playdrop-ai/playdrop-skills --skill playdrop