Skip to content
Back to search

team-marketplace

Private skills marketplace for REPLACE_ME_company_name.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bradautomates--company-skills-marketplace-template/badge.svg)](/listings/bradautomates--company-skills-marketplace-template)

HTML

<a href="/listings/bradautomates--company-skills-marketplace-template"><img src="/api/listings/bradautomates--company-skills-marketplace-template/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Click **Use this template** → **Create a new repository** at the top of this page. Set visibility to **Private**, name it (e.g. `acme-skills-marketplace`), and create. From here on, that new repo — not this template — is your marketplace.

1. Clone the repo locally

The easiest way is to ask Claude Code to do it for you:

> *clone `<your-username>/<your-new-repo>` into ~/code and open it*

Or run the commands manually:

gh repo clone <your-username>/<your-new-repo>
cd <your-new-repo>
code .

2. Install the management plugin (first time only)

In the **Claude Desktop app**:

- **Customise** → **+** button → **Create Plugin** → **Add marketplace** - Enter your repo as `<your-username>/<your-new-repo>` - Install the `marketplace-admin` plugin from the marketplace that appears

Or, equivalently, from a Claude Code session:

/plugin marketplace add <your-username>/<your-new-repo>
/plugin install marketplace-admin@team-marketplace

> *(The marketplace is called `team-marketplace` at this point — that's the pre-init default. Step 3 renames it.)* > > **If install fails:** the `gh` CLI probably isn't installed or signed in. Ask Claude Code to install and authenticate `gh`, then retry.

3. Run setup with the management skill

Open the local clone from step 1 in Claude Code. From a session inside that directory, say:

> *setup my marketplace*

The `marketplace-manager` skill walks you through:

- Your company name - Your marketplace name (replaces `team-marketplace`) - License (MIT or UNLICENSED)

It rewrites all the placeholders across both runtimes' manifests, swaps this marketing README for a teammate-facing one with install commands inline, and commits.

4. Push to GitHub

The skill pushes for you. (If you skipped that prompt, just run `git push`.)

5. Refresh the plugin

Your marketplace was renamed in step 3, so update the plugin reference in your runtime:

- **Claude Desktop app:** Customise → marketplace → **Update** (or **Refresh**) - **CLI:** `/plugin marketplace update <new-marketplace-name>`

6. Give teammates access and share the repo

GitHub → your repo → **Settings** → **Collaborators and teams** → invite each teammate's GitHub account (or grant a team read access). Without this, their install will fail with a not-found error.

Then share the repo URL. After step 3, the README on the front page has copy-paste install commands inline for both Claude Code and Codex.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "team-marketplace",
  3. "owner": {
  4. "name": "REPLACE_ME_company_name"
  5. },
  6. "description": "Private skills marketplace for REPLACE_ME_company_name.",
  7. "plugins": [
  8. {
  9. "name": "team-skills",
  10. "source": "./plugins/team-skills",
  11. "description": "Skills shared across the team."
  12. },
  13. {
  14. "name": "marketplace-admin",
  15. "source": "./plugins/marketplace-admin",
  16. "description": "Owner-only tooling for managing this marketplace. Do not install on teammate machines."
  17. }
  18. ]
  19. }
README.md · README · 213 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Company Skills Marketplace
  2. A GitHub template for spinning up a **private skills marketplace** for your team in under 10 minutes. Works with both [Claude Code](https://claude.ai/code) and [Codex CLI](https://github.com/openai/codex).
  3. > **Stop copy-pasting skills around in Slack.** If your team uses Claude Code or Codex individually, this template gives you a shared execution layer: one private repo, one install command per teammate, and skills that update across the team automatically.
  4. ## Why use this
  5. - **Tool-agnostic execution layer.** New AI coding tools drop every month. You don't want your team's skills locked into one vendor's ecosystem — this template gives you a shared layer that works across **two of the most popular AI agent harnesses** (Claude Code and Codex CLI) from a single source of truth. Add another runtime later? Mirror the manifest and you're done.
  6. - **Scales with your team.** Start with one `team-skills` plugin on day one. When you grow into distinct functions, scaffold new plugins per area of the business — `sales-skills`, `ops-skills`, `marketing-skills` — with one natural-language command. Teammates install only what's relevant to them.
  7. - **Free to set up and run.** No Teams or Enterprise plan required. No SaaS fee, no extra services, no infrastructure to host. You're using primitives that ship in the box with both runtimes.
  8. - **Version control and collaboration built in.** Skills are just files in a Git repo, so every change is reviewable in PRs, every version is recoverable, and teammates can collaborate on skill authoring the way they already collaborate on code.
  9. - **Private by default.** Your skills stay in your private GitHub repo. Auth piggybacks on the GitHub access your team already has.
  10. ## What this is
  11. Both Claude Code and Codex support private plugin marketplaces natively, with near-identical primitives. This template wires up both with sensible defaults so you don't have to read either spec:
  12. - **Native marketplaces, both runtimes.** Uses `.claude-plugin/marketplace.json` (Claude Code) and `.agents/plugins/marketplace.json` (Codex) side-by-side. No extra services to run.
  13. - **One shared `skills/` tree.** SKILL.md format is identical across runtimes, so your team writes a skill once and both ecosystems load it.
  14. - **Two plugins out of the box.** `team-skills` is where your team's skills live (one example skill ships so you can confirm install works). `marketplace-admin` ships an owner-only `marketplace-manager` skill that handles setup, importing skills, publishing, and status — usable from any session, anywhere on disk.
  15. - **Private by default.** Designed assuming you fork private. Auth via your team's existing GitHub access.
  16. - **Auto-update.** Teammates enable auto-update once; new skills land on next startup.
  17. ## Who this is for
  18. Business owners and small-team operators who already use Claude Code or Codex individually and want their team to share the same execution layer — without rebuilding skills from scratch or copy-pasting them in Slack.
  19. ## Prerequisites
  20. - [Claude Code](https://claude.ai/code) **or** [Codex CLI](https://github.com/openai/codex) (or both) installed
  21. - A GitHub account with permission to create private repos
  22. - A code editor (e.g. VS Code) to open the cloned repo in
  23. > The `gh` CLI is used under the hood for private repo access. If a step below fails because `gh` isn't installed or authenticated, just ask Claude Code: *"install the GitHub CLI and authenticate with my GitHub account"* — then retry the failing step.
  24. ## First-time setup — Claude Code
  25. Click **Use this template** → **Create a new repository** at the top of this page. Set visibility to **Private**, name it (e.g. `acme-skills-marketplace`), and create. From here on, that new repo — not this template — is your marketplace.
  26. ### 1. Clone the repo locally
  27. The easiest way is to ask Claude Code to do it for you:
  28. > *clone `<your-username>/<your-new-repo>` into ~/code and open it*
  29. Or run the commands manually:
  30. ```
  31. gh repo clone <your-username>/<your-new-repo>
  32. cd <your-new-repo>
  33. code .
  34. ```
  35. ### 2. Install the management plugin (first time only)
  36. In the **Claude Desktop app**:
  37. - **Customise** → **+** button → **Create Plugin** → **Add marketplace**
  38. - Enter your repo as `<your-username>/<your-new-repo>`
  39. - Install the `marketplace-admin` plugin from the marketplace that appears
  40. Or, equivalently, from a Claude Code session:
  41. ```
  42. /plugin marketplace add <your-username>/<your-new-repo>
  43. /plugin install marketplace-admin@team-marketplace
  44. ```
  45. > *(The marketplace is called `team-marketplace` at this point — that's the pre-init default. Step 3 renames it.)*
  46. >
  47. > **If install fails:** the `gh` CLI probably isn't installed or signed in. Ask Claude Code to install and authenticate `gh`, then retry.
  48. ### 3. Run setup with the management skill
  49. Open the local clone from step 1 in Claude Code. From a session inside that directory, say:
  50. > *setup my marketplace*
  51. The `marketplace-manager` skill walks you through:
  52. - Your company name
  53. - Your marketplace name (replaces `team-marketplace`)
  54. - License (MIT or UNLICENSED)
  55. It rewrites all the placeholders across both runtimes' manifests, swaps this marketing README for a teammate-facing one with install commands inline, and commits.
  56. ### 4. Push to GitHub
  57. The skill pushes for you. (If you skipped that prompt, just run `git push`.)
  58. ### 5. Refresh the plugin
  59. Your marketplace was renamed in step 3, so update the plugin reference in your runtime:
  60. - **Claude Desktop app:** Customise → marketplace → **Update** (or **Refresh**)
  61. - **CLI:** `/plugin marketplace update <new-marketplace-name>`
  62. ### 6. Give teammates access and share the repo
  63. GitHub → your repo → **Settings** → **Collaborators and teams** → invite each teammate's GitHub account (or grant a team read access). Without this, their install will fail with a not-found error.
  64. Then share the repo URL. After step 3, the README on the front page has copy-paste install commands inline for both Claude Code and Codex.
  65. ## First-time setup — Codex CLI
  66. Same shape as Claude Code, with one difference at the end: Codex has no auto-update, so you reload your Codex session to pick up the renamed marketplace.
  67. ### 1. Clone the repo locally
  68. Same as above — `gh repo clone <your-username>/<your-new-repo>`, `cd` in, open in your editor.
  69. ### 2. Install the management plugin
  70. ```
  71. codex plugin marketplace add <your-username>/<your-new-repo>
  72. codex plugin install marketplace-admin@team-marketplace
  73. ```
  74. If this fails because `gh` isn't set up, install/authenticate it and retry.
  75. ### 3. Run setup
  76. From a Codex session inside the local clone:
  77. > *setup my marketplace*
  78. Same prompts as Claude Code (company name, marketplace name, license).
  79. ### 4. Push to GitHub
  80. The skill pushes for you.
  81. ### 5. Reload Codex
  82. Quit and restart your Codex session, then pull the renamed marketplace:
  83. ```
  84. codex plugin marketplace upgrade <new-marketplace-name>
  85. ```
  86. ### 6. Give teammates access and share the repo
  87. Same as Claude Code step 6.
  88. ## Adding a new skill
  89. Once `marketplace-admin` is installed, you can add skills from anywhere on disk — no need to be inside the marketplace clone.
  90. 1. Open the repo or directory where the skill lives in Claude Code or Codex.
  91. 2. Trigger the management skill: *"add this skill to the team marketplace"* (name the skill if there are several to choose from).
  92. 3. The skill copies the skill into your `team-skills` plugin (or whichever plugin you point it at), bumps the plugin version, commits, and pushes.
  93. 4. Teammates pick it up on their next runtime startup (with auto-update on) or by running an upgrade command.
  94. > **Recommend to your team:** in Claude Code, run `/plugin`, select your marketplace, and toggle **Enable auto-update**. New skills land automatically on next startup. Codex teammates run `codex plugin marketplace upgrade <marketplace>` periodically.
  95. ## Adding a new plugin (e.g. sales, marketing, ops)
  96. When one `team-skills` plugin starts feeling too broad, split into domain plugins. From anywhere on disk, trigger the management skill:
  97. > *add a new plugin called `sales-skills` to the marketplace*
  98. It scaffolds the plugin directory, registers it in both runtimes' manifests, commits, and pushes. Teammates install the new plugin selectively:
  99. ```
  100. /plugin install sales-skills@<your-marketplace-name>
  101. # or
  102. codex plugin install sales-skills@<your-marketplace-name>
  103. ```
  104. ## Other ongoing flows
  105. The management skill also handles:
  106. - *"publish to the marketplace"* — commits and pushes pending changes.
  107. - *"marketplace status"* — shows pending changes and recent ships.
  108. It saves your local clone's path at `~/.config/claude-marketplace-admin/config.json` so it works from any working directory. Both runtimes' manifests stay in sync automatically — never edit one without the other.
  109. ## What's in the box
  110. ```
  111. .claude-plugin/marketplace.json # Claude Code marketplace registry
  112. .agents/plugins/marketplace.json # Codex marketplace registry
  113. plugins/
  114. team-skills/ # where your team's skills live
  115. .claude-plugin/plugin.json
  116. .codex-plugin/plugin.json
  117. skills/example-skill/ # delete after first install
  118. marketplace-admin/ # owner-only management plugin
  119. .claude-plugin/plugin.json
  120. .codex-plugin/plugin.json
  121. skills/marketplace-manager/ # init, import, add-plugin, publish, status
  122. CLAUDE.md # design rationale (auto-loaded by Claude Code)
  123. AGENTS.md # @CLAUDE.md (auto-loaded by Codex)
  124. CONTEXT.md # domain glossary
  125. docs/
  126. adr/ # architecture decisions
  127. install-claude-code.md # teammate install guide (Claude Code)
  128. install-codex.md # teammate install guide (Codex)
  129. README.md # this file (replaced by instance README on init)
  130. README.instance.md # post-init README (with sentinels)
  131. LICENSE # MIT (changeable during init)
  132. .gitignore
  133. ```
  134. ## About
  135. Built by [Brad Bonanno](https://www.youtube.com/@bradbonanno) at [Solaris Automation](https://www.solarisautomation.io/) — we help teams ship AI-powered workflows without rebuilding infra. Subscribe on [YouTube](https://www.youtube.com/@bradbonanno) for walkthroughs of templates like this one.
  136. ## License
  137. MIT in this template (replace during init if you want UNLICENSED for proprietary internal use).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.