Primatrix Skills Plugin Marketplace

A Claude Code plugin marketplace containing reusable Agent Skills and workflow plugins. The same repository can also be used by Codex through codex plugin and by Gemini CLI through individual skill installs.

A Skill is a set of structured instructions, usually defined in a SKILL.md file, that teaches an AI coding agent how to perform a specific workflow. A plugin can bundle skills together with slash commands, hooks, agents, and supporting scripts.

tpu-perf replaces the older tpu-perf-model plugin.

Add this repository as a marketplace, then install the plugins you need:

/plugin marketplace add primatrix/skills

/plugin install agent-recap@primatrix-skills
/plugin install beaver@primatrix-skills
/plugin install exec-remote@primatrix-skills
/plugin install gcloud-support-case@primatrix-skills
/plugin install gke-tpu@primatrix-skills
/plugin install lint-fix@primatrix-skills
/plugin install session-recorder@primatrix-skills
/plugin install superpowers@primatrix-skills
/plugin install tpu-perf@primatrix-skills
/plugin install xprof-profiling-analysis@primatrix-skills

For project-local installs, add --scope project:

/plugin install superpowers@primatrix-skills --scope project
/plugin install tpu-perf@primatrix-skills --scope project

Verify from a Claude Code session:

/plugin list

Codex can consume this repository as a plugin marketplace:

codex plugin marketplace add primatrix/skills --ref main
codex plugin list --marketplace primatrix-skills

codex plugin add agent-recap@primatrix-skills
codex plugin add beaver@primatrix-skills
codex plugin add exec-remote@primatrix-skills
codex plugin add gcloud-support-case@primatrix-skills
codex plugin add gke-tpu@primatrix-skills
codex plugin add lint-fix@primatrix-skills
codex plugin add session-recorder@primatrix-skills
codex plugin add superpowers@primatrix-skills
codex plugin add tpu-perf@primatrix-skills
codex plugin add xprof-profiling-analysis@primatrix-skills

Refresh an already-added marketplace snapshot before installing newly-added plugins:

codex plugin marketplace upgrade primatrix-skills
codex plugin list --marketplace primatrix-skills

Verify installed plugins:

codex plugin list

Gemini CLI installs individual skill directories. Use the paths from Skill Inventory:

gemini skills install https://github.com/primatrix/skills.git --path plugins/superpowers/skills/using-superpowers
gemini skills install https://github.com/primatrix/skills.git --path plugins/superpowers/skills/brainstorming
gemini skills install https://github.com/primatrix/skills.git --path plugins/tpu-perf/skills/profile-anatomy
gemini skills install https://github.com/primatrix/skills.git --path plugins/tpu-perf/skills/comm-analysis
gemini skills install https://github.com/primatrix/skills.git --path plugins/exec-remote/skills/exec-remote

Install into the current workspace instead of user scope:

gemini skills install https://github.com/primatrix/skills.git --path plugins/tpu-perf/skills/profile-anatomy --scope workspace

Verify:

gemini skills list

.claude-plugin/
└── marketplace.json              # Marketplace definition and plugin registry
plugins/
└── <plugin-name>/
    ├── .claude-plugin/
    │   └── plugin.json           # Claude/Codex marketplace plugin manifest
    ├── .codex-plugin/            # Optional Codex-specific plugin manifest
    ├── .cursor-plugin/           # Optional Cursor-specific plugin manifest
    ├── commands/                 # Optional slash commands
    ├── agents/                   # Optional agent prompts
    ├── hooks/                    # Optional runtime hooks
    └── skills/
        └── <skill-name>/
            ├── SKILL.md          # Skill frontmatter and instructions
            └── scripts/          # Optional supporting scripts

When changing a plugin locally, test it from a local marketplace checkout before publishing.

Codex can install directly from the local repository:

cd /path/to/skills
codex plugin marketplace add /path/to/skills
codex plugin add superpowers@primatrix-skills

If the remote primatrix-skills marketplace is already registered, remove it first or use a temporary copy with a different .claude-plugin/marketplace.json name.

Claude Code can point at a local marketplace path through the same marketplace flow:

/plugin marketplace add /path/to/skills
/plugin install superpowers@primatrix-skills

After editing skills, restart the agent session or reload plugins so the updated SKILL.md files are loaded.

To add or update a plugin:

1. Create or update plugins/<plugin-name>/.
2. Keep .claude-plugin/plugin.json in sync with the plugin name, description, and version.
3. Add skills under skills/<skill-name>/SKILL.md.
4. Add commands, agents, hooks, or scripts only when the plugin actually needs them.
5. Register the plugin in .claude-plugin/marketplace.json.
6. Update this README's plugin table, skill inventory, and install commands.
7. Submit a pull request.

Apache License 2.0