🤖 Claude Superskills v2.0.8

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

Or let the interactive installer detect Cowork and offer it as a packaging target:

npx claude-superskills

The installer will generate a zip like:

~/.claude-superskills/plugin-output/claude-superskills-v2.0.3.zip

Then update Cowork manually:

1. Open Claude Desktop.
2. Switch to Cowork.
3. Open Customize.
4. Find the existing claude-superskills plugin.
5. Remove the previous version first.
6. Upload the new zip generated by the installer.
7. Confirm the new version appears in Cowork.

Important:

• The historical claude plugin install bug affects the GitHub/CLI install flow, not the Cowork custom zip upload flow.
• Cowork is treated as package + manual upload, not as an auto-installed ~/.claude/skills/ target.
• Current support level: validated on macOS; Windows and Linux detection are implemented as best-effort heuristics and should be treated as not yet fully validated in real Cowork environments.

Once installed — all 18 skills under the claude-superskills: namespace

/claude-superskills:skill-creator
/claude-superskills:prompt-engineer
/claude-superskills:brainstorming
/claude-superskills:writing-plans
/claude-superskills:executing-plans
/claude-superskills:grill-me
/claude-superskills:mckinsey-strategist
/claude-superskills:deep-research
/claude-superskills:us-program-research
/claude-superskills:webpage-reader
/claude-superskills:senior-solution-architect
/claude-superskills:agent-skill-discovery
/claude-superskills:agent-skill-orchestrator
/claude-superskills:youtube-summarizer
/claude-superskills:audio-transcriber
/claude-superskills:pptx-translator
/claude-superskills:document-converter
/claude-superskills:storytelling-expert

npm install still works for GitHub Copilot, Cursor IDE, Gemini CLI, and 5 other platforms. The plugin format is Claude Code-specific.

✨ Features

• 18 Universal Skills - Work on all platforms
• Zero-Config Install - Run once, works everywhere
• Curated Bundles - Install exactly what you need
• Smart Search - Find skills by keyword
• 8 Platform Support - GitHub Copilot, Claude Code, Codex, OpenCode, Gemini, Antigravity, Cursor, AdaL
• Discovery & Orchestration - Find and plan with available resources
• Command Shortcuts - i, ls, up, rm, doc
• Short Flags - -a, -y, -q

📦 Available Skills

🔍 Discovery & Orchestration

🛠️ Development & Automation

🧭 Planning & Execution

🏛️ Software Architecture

🔬 Research & Analysis

📝 Content Processing

🎯 Curated Bundles

# Essential Skills (recommended for beginners)
npx claude-superskills --bundle essential -y

# Content Creation (video & audio)
npx claude-superskills --bundle content -y

# Planning & Execution
npx claude-superskills --bundle planning -y

# Research & Analysis
npx claude-superskills --bundle research -y

# Discovery & Orchestration
npx claude-superskills --bundle orchestration -y

# All Skills (complete collection)
npx claude-superskills --bundle all -y

See Bundles Guide for details.

🔍 Search Skills

npx claude-superskills --search "prompt"
npx claude-superskills --search "video"

🚀 Quick Start Examples

Discovery & Planning Workflow

# 1. Discover what's available
claude  # or: gh copilot, gemini, opencode, codex
> "What do I have installed?"

# Output: Lists installed and current-repository plugins, skills, MCPs

# 2. Get intelligent execution plan
> "Plan how to build a REST API with authentication"

# Output: Detailed strategy using best available resources with confidence scores

Other Use Cases

# Create a new skill
gh copilot -p "create a skill for PDF processing"

# Optimize a prompt
claude -p "improve this prompt: create REST API"

# Process content
gh copilot -p "transcribe this audio file: meeting.mp3"

# Orchestrate complex tasks
gemini -p "design a solution for processing meeting notes and creating Jira tickets"

💻 Supported Platforms

• GitHub Copilot CLI - Terminal AI assistant (~/.copilot/skills/)
• Claude Code - Anthropic's Claude in development (~/.claude/skills/)
• OpenAI Codex - GPT-powered coding assistant (~/.codex/skills/)
• OpenCode - Open source AI coding assistant (~/.agent/skills/)
• Gemini CLI - Google's Gemini in terminal (~/.gemini/skills/)
• Antigravity - AI coding assistant (~/.gemini/antigravity/skills/)
• Cursor IDE - AI-powered code editor (~/.cursor/skills/)
• AdaL CLI - AI development assistant (~/.adal/skills/)

Note on Codex: The installer uses ~/.codex/skills/ for Codex CLI + App, with cleanup support for legacy ~/.agents/skills/.

⌨️ Compatibility & Invocation

These skills follow the universal SKILL.md format and work with any AI coding assistant that supports agentic skills.

Tip: OpenCode uses ~/.agent/skills/; Antigravity uses ~/.gemini/antigravity/skills/.

📚 Documentation

• Getting Started - First-time user guide
• Skill Anatomy - How skills work
• Bundles Guide - Curated collections
• Quality Standards - Best practices
• Full Catalog - Complete skill listing

⚡ CLI Commands & Shortcuts

npx claude-superskills i -a -y -q    # Install all, skip prompts, quiet mode
npx claude-superskills status         # Show global status + skill version differences
npx claude-superskills up -y          # Update outdated + install missing skills
npx claude-superskills ls -q          # List with minimal output
npx claude-superskills --list-bundles # Show available bundles

📋 System Requirements

• Node.js 14+ (for installer)
• One or more supported platforms installed
• Python 3.8+ (for some skills with dependencies)

🤝 Contributing

We welcome contributions! Check CONTRIBUTING.md for guidelines.

• Create new skills using the skill-creator skill
• Follow Quality Standards
• Report issues and suggestions

🔒 Privacy

claude-superskills does not collect, store, transmit, or share any user data.

• No external servers — the plugin has no backend, no telemetry, and no network requests of its own
• No API keys required — all skills run entirely within Claude Code using Claude's native tools (WebSearch, WebFetch, Bash, Read/Write)
• No logging — nothing is recorded outside of your local Claude Code session
• Open source — all skill logic is fully auditable at github.com/ericgandrade/claude-superskills

Any web searches or document fetches performed by skills use Claude Code's built-in tools, subject to Anthropic's own privacy policy.

📄 License

MIT - See LICENSE for details.

🔗 Quick Links

• 📚 Full Catalog - All skills with metadata
• 🛠️ Skills Development Guide - Create custom skills
• 📝 Changelog - Release history
• 🐛 Issues - Report problems
• 💬 Discussions - Share ideas

Built with ❤️ by Eric Andrade

Version 2.0.8 | May 2026

🎁 Get Started

Choose a bundle that fits your workflow:

• Essential - skill-creator, prompt-engineer, agent-skill-discovery, agent-skill-orchestrator
• Planning - brainstorming, writing-plans, executing-plans, grill-me, mckinsey-strategist, agent-skill-orchestrator
• Research - deep-research, us-program-research, agent-skill-discovery, prompt-engineer
• Content - youtube-summarizer, audio-transcriber, pptx-translator, document-converter, storytelling-expert
• Orchestration - agent-skill-discovery, agent-skill-orchestrator
• All - Complete 18-skill toolkit

See detailed comparison.

🛠️ Advanced Usage

• Skill Anatomy - How to build skills
• Skills Development - Advanced creation
• Changelog - Version history

Part of the Superskills Family

Getting Started? Check Quick Start or run npx claude-superskills now!