claude-superskills

🤖 Claude Superskills v1.22.0

Scale AI-assisted engineering with a reusable skill platform that turns ad-hoc prompting into standardized, high-impact workflows. Install once and deliver consistent planning, research, orchestration, and content automation across your entire multi-tool AI stack.

🚀 Quick Install

One-liner (recommended):

curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash

Or use NPX (zero-install):

npx claude-superskills

The installer always uses global installation (~/.<platform>/skills), compares installed skill versions with the current installer version, shows differences, and recommends updates/new installs automatically.

Other methods:

# npm global
npm install -g claude-superskills

# With bundles
npx claude-superskills --bundle essential -y

Local install (no npm/npx required):

If you have cloned the repository and want to install skills directly, without any internet download or Node.js:

git clone https://github.com/ericgandrade/claude-superskills
cd claude-superskills

# Interactive — choose which platforms to install to
./scripts/local-install.sh

# Auto-install to all detected platforms
./scripts/local-install.sh -y

# Silent auto-install (CI / scripted environments)
./scripts/local-install.sh -y -q

The script reads directly from skills/, detects your installed platforms, and copies everything into the right directories. No Node.js, no npm, no internet.

See Installation Guide for all methods and troubleshooting.

Uninstall:

curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/uninstall.sh | bash

🔌 Claude Code Plugin (Native)

Use claude-superskills as a native Claude Code plugin — no npm, no Node.js required. Requires Claude Code v1.0.33+ (claude --version to check).

---

Option A — Claude Code CLI (Terminal)

⚠️ Important: While the universal installer (npx claude-superskills) works perfectly to copy skills into ~/.claude/skills/, using the native Claude Code Plugin system (described below) is the recommended and most suitable installation method for Claude Code users.

Method 1: Interactive UI (Inside a running claude session) — Recommended

Start a Claude Code session:

claude

Then run these slash commands inside the session:

# 1. Add the marketplace
/plugin marketplace add ericgandrade/claude-superskills

# 2. Install the plugin
/plugin install claude-superskills@claude-superskills

Alternatively, open the plugin manager with /plugin → navigate to the Discover tab → search for "claude-superskills" → press Enter → choose your preferred scope.

Method 2: Shell command (Outside a session)

🐛 Known Bug: The claude plugin install shell command is currently failing due to an upstream issue in Claude Code. We strongly recommend using the interactive in-session method above. If you prefer a CLI approach, the universal installer (npx claude-superskills) is completely reliable and stable. Tracked at: anthropics/claude-code#29722.

# Attempt to add marketplace + install in one flow (Currently unstable)
claude plugin install claude-superskills@claude-superskills

Choose your scope with --scope:

claude plugin install claude-superskills@claude-superskills --scope user     # all your projects (default)
claude plugin install claude-superskills@claude-superskills --scope project  # team-shared via .claude/settings.json
claude plugin install claude-superskills@claude-superskills --scope local    # this project only, gitignored

Method 3: Local test (no install needed)

git clone https://github.com/ericgandrade/claude-superskills
claude --plugin-dir ./claude-superskills

---

Option B — Claude.ai Web (claude.ai)

Plugin installation on claude.ai requires the plugin to be listed in the official Anthropic marketplace. Submission is pending. Once approved, you will be able to install directly from:

Settings → Extensions → Browse Plugins on claude.ai

To be notified when the plugin is available on claude.ai, watch this repository.

---

Option C — Claude Desktop Cowork (Custom Plugin Upload)

If you use Claude Desktop with Cowork, the safest path is to generate a plugin zip locally and upload it manually in Cowork. This path does not depend on the claude plugin install shell flow.

Generate the package with the installer:

npx claude-superskills package-cowork