xiaohongshu
xiaohongshu
managing-marketplaces
Use when working with Claude Code plugin marketplaces - adding, updating, creating, or understanding how marketplace versioning and caching work.
Full skill instructions
Plugin marketplaces are catalogs of available plugins. This skill covers how updates work, caching, and versioning.
| Path | Purpose |
|---|---|
~/.claude/plugins/marketplaces/ | Git clones of remote marketplaces |
~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/ | Cached plugin versions |
~/.claude/plugins/known_marketplaces.json | Marketplace registry with update timestamps |
Marketplaces track main branch HEAD - no commit pinning:
// known_marketplaces.json
{
"superpowers-marketplace": {
"source": {
"source": "git",
"url": "https://github.com/obra/superpowers-marketplace.git"
},
"lastUpdated": "2026-01-09T15:25:06.447Z",
"autoUpdate": true
}
}
autoUpdate: true pulls latest on startup/refreshPlugins ARE versioned via the version field in plugin.json:
~/.claude/plugins/cache/
├── superpowers-marketplace/
│ └── superpowers/
│ └── 4.0.3/ ← version from plugin.json
└── claude-plugins-official/
└── hookify/
└── e30768372b41/ ← commit hash for official plugins
digraph update_flow {
rankdir=TB;
"Claude Code starts" [shape=box];
"Pull marketplace (git pull main)" [shape=box];
"Read marketplace.json" [shape=box];
"For each enabled plugin" [shape=diamond];
"Check if version cached" [shape=diamond];
"Use cached version" [shape=box];
"Fetch plugin from source" [shape=box];
"Cache at version directory" [shape=box];
"Claude Code starts" -> "Pull marketplace (git pull main)";
"Pull marketplace (git pull main)" -> "Read marketplace.json";
"Read marketplace.json" -> "For each enabled plugin";
"For each enabled plugin" -> "Check if version cached";
"Check if version cached" -> "Use cached version" [label="yes"];
"Check if version cached" -> "Fetch plugin from source" [label="no"];
"Fetch plugin from source" -> "Cache at version directory";
"Cache at version directory" -> "For each enabled plugin";
"Use cached version" -> "For each enabled plugin";
}
| Layer | Pinned? | Update Mechanism |
|---|---|---|
| Marketplace | No (tracks main HEAD) | autoUpdate: true or /plugin marketplace update |
| Plugin | Yes (version field) | Bump version in plugin.json → new cache dir |
# List known marketplaces
/plugin marketplace list
# Update marketplace metadata
/plugin marketplace update <marketplace-name>
# Add marketplace
/plugin marketplace add owner/repo # GitHub
/plugin marketplace add ./local-path # Local
/plugin marketplace add https://url.git # Git URL
# Remove marketplace (also uninstalls plugins from it)
/plugin marketplace remove <marketplace-name>
For marketplaces with a CLI for managing symlinks, use it:
cd ~/projects/my-marketplace
pnpm install
pnpm ccd link activate # Symlink all plugins (creates cache if needed)
pnpm ccd link review # Check status
pnpm ccd link deactivate # Remove symlinks
Run pnpm ccd --help for full documentation including path resolution diagrams.
Workflow:
pnpm ccd link activate (no install required)claude plugin install (overwrites symlinks)For marketplaces without the CLI, manually replace cache with symlinks.
Key insight: Cache path uses marketplace's name field from marketplace.json, not the source (GitHub vs local). So ~/.claude/plugins/cache/<name>/... is the same whether you installed from GitHub or local path.
# 1. Clone repo locally (if not already)
git clone https://github.com/owner/marketplace ~/projects/my-marketplace
# 2. If not installed, add and install (skip if already from GitHub)
claude plugin marketplace add ~/projects/my-marketplace
claude plugin install my-plugin@my-marketplace
# 3. Replace cache with symlink (works for GitHub or local installs)
rm -rf ~/.claude/plugins/cache/<marketplace-name>/my-plugin/*/
ln -s ~/projects/my-marketplace/plugins/my-plugin \
~/.claude/plugins/cache/<marketplace-name>/my-plugin/<version>
Caveats:
Why this works: CC loads plugins from cache path. Symlink makes cache path point to source. CC follows symlinks transparently.
Official docs show uninstall/reinstall cycle:
/plugin uninstall my-plugin@my-marketplace
/plugin install my-plugin@my-marketplace
In project or user settings.json:
{
"enabledPlugins": {
"plugin-name@marketplace-name": true
}
}
CRITICAL: When creating a new plugin, you MUST do BOTH:
plugin.jsonmarketplace.jsonmarketplace/
├── .claude-plugin/
│ └── marketplace.json ← MUST add entry here
└── plugins/
└── new-plugin/
└── plugin.json ← AND create this
Failure mode: Creating only the directory results in /doctor errors like:
Plugin new-plugin not found in marketplace marketplace-name
plugins/<name>/plugin.json with name, version, description.claude-plugin/marketplace.json plugins arrayname, source (e.g., "./plugins/<name>"), description/doctor to verify no plugin errorslastUpdated timestamp tracks when marketplace was last refreshedxiaohongshu
technical spec
product ux expert
database patterns
Conduct multi-agent task orchestration and workflow coordination.
Initialize project with Conductor artifacts (product definition,
Expert in web animations, transitions, and motion design using Framer Motion and CSS
Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...
PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.
Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...
Display project status, active tracks, and next actions
Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience