/plugin marketplace — Skill Marketplace

Manage GGV3 skills sourced from GitHub repositories and npm packages.

Commands

/plugin marketplace add <owner>/<repo>           # Install a skill from GitHub
/plugin marketplace remove <skill-name>          # Remove an installed skill
/plugin marketplace list                         # List installed skills
/plugin marketplace search <query>               # Search GitHub for skills

/plugin marketplace add <owner>/<repo>

Install a skill or tool from a GitHub repository into

.agent/skills/

Step 1 — Resolve the source

Determine source type from the identifier:

owner/repo

anthropics/claude-code

owner/repo#skill-name

google/skills#web-perf

npm:package-name

npm:@anthropic-ai/claude-code

Step 2 — Fetch metadata from GitHub

// turbo

gh repo view <owner>/<repo> --json name,description,url,defaultBranchRef 2>/dev/null || echo "REPO_NOT_FOUND"

If

REPO_NOT_FOUND

npm view <package-name> name description version 2>/dev/null || echo "PKG_NOT_FOUND"

Step 3 — Determine install type

Type A — CLI Tool (npm package): If the source is an npm package or the repo's

package.json

bin

npm install -g <package-name>

Then create a thin skill wrapper:

.agent/skills/<tool-name>/
├── SKILL.md          # Documents the CLI, trigger patterns, usage

Type B — Skill Repository (has SKILL.md): If the repo contains a

SKILL.md

# Clone to temp, extract skill files
git clone --depth 1 https://github.com/<owner>/<repo>.git /tmp/plugin-install-<repo>
cp -r /tmp/plugin-install-<repo>/ .agent/skills/<skill-name>/
rm -rf /tmp/plugin-install-<repo>

Type C — Reference Repository (no SKILL.md, no bin): Create a new skill based on the repo's README and source code:

1. Read the repo's README via GitHub API
2. Analyze what the tool/library does
3. Create a SKILL.md that documents:
   • When to use the tool
   • How it was installed (CLI, library, etc.)
   • Key commands and patterns
   • Trigger keywords for auto-invoke

Step 4 — Create/validate SKILL.md

Every installed plugin MUST have a valid SKILL.md with:

---
name: <skill-name>
version: <semver or repo SHA>
source: <owner>/<repo> OR npm:<package>
installed: <ISO-8601 timestamp>
description: <one-line description>
---

Followed by:

• When to use — Clear trigger conditions
• Installation — How it was installed, dependencies
• Usage — Key commands, APIs, patterns
• Examples — At least one usage example

Step 5 — Register the skill

A) Add to

.agent/rules/skill-auto-invoke.md

| <skill-name> | .agent/skills/<skill-name>/SKILL.md | <trigger keywords> |

B) Add to

CLAUDE.md

<skill_registry>

| <skill-name> | .agent/skills/<skill-name>/SKILL.md | <trigger keywords> |

Note:

AGENTS.md

,

GEMINI.md

, and

codex.md

are symlinks to

CLAUDE.md

— updating one updates all.

Step 6 — Verify installation

# For CLI tools — verify the binary exists
which <tool-name> && <tool-name> --version

# For skills — verify SKILL.md exists and is valid
cat .agent/skills/<skill-name>/SKILL.md | head -20

Step 7 — Report installation summary

Output a summary:

✅ Plugin installed: <skill-name>
   Source: <owner>/<repo> (or npm:<package>)
   Type: CLI Tool | Skill | Reference
   Location: .agent/skills/<skill-name>/
   Triggers: <comma-separated trigger keywords>

/plugin marketplace remove <skill-name>

Step 1 — Verify skill exists

ls .agent/skills/<skill-name>/SKILL.md 2>/dev/null || echo "SKILL_NOT_FOUND"

Step 2 — Check for npm global package

Read the SKILL.md frontmatter for a

source: npm:*

npm uninstall -g <package-name>

Step 3 — Remove skill directory

rm -rf .agent/skills/<skill-name>

Step 4 — Deregister from skill registry

Remove the skill's row from:

• .agent/rules/skill-auto-invoke.md

• CLAUDE.md

  <skill_registry>

  section

Step 5 — Confirm removal

🗑️ Plugin removed: <skill-name>

/plugin marketplace list

Step 1 — Enumerate installed skills

// turbo

for skill in .agent/skills/*/SKILL.md; do
  name=$(basename $(dirname "$skill"))
  source=$(grep -m1 '^source:' "$skill" 2>/dev/null | sed 's/source: *//')
  version=$(grep -m1 '^version:' "$skill" 2>/dev/null | sed 's/version: *//')
  echo "$name | $source | $version"
done

Step 2 — Format as table

/plugin marketplace search <query>

Step 1 — Search GitHub

Use the GitHub MCP

search_repositories

query: "<query> topic:agent-skill OR topic:claude-skill OR topic:mcp-tool"

Or search for code patterns:

query: "SKILL.md name: <query>"

Step 2 — Display results

Step 3 — Prompt for install

Ask: "Would you like to install any of these? Use

/plugin marketplace add <owner>/<repo>

Known Plugin Sources

Notes

• All skills are installed to

  .agent/skills/<name>/

• CLI tools are installed globally via npm and get a thin SKILL.md wrapper
• The SKILL.md frontmatter

  source:

  field tracks provenance for updates
• Use

  installed:

  timestamp to track when a plugin was added