claude-superskills

🤖 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

Skill	Version	Purpose
agent-skill-discovery	v2.1.0	Scan installed resources and current repository resources (agents, skills, MCPs)
agent-skill-orchestrator	v2.1.0	Intelligent task planning with automatic prompt optimization and resource matching

🛠️ Development & Automation

Skill	Version	Purpose
skill-creator	v2.1.0	Automate skill creation with guided workflow
prompt-engineer	v2.0.0	Optimize prompts using 11 frameworks (RTF, RISEN, Chain of Thought, etc.)

🧭 Planning & Execution

Skill	Version	Purpose
brainstorming	v2.0.0	Mandatory pre-implementation design clarification workflow
writing-plans	v2.0.0	Build detailed, actionable implementation plans before coding
executing-plans	v2.0.0	Execute plans in batches with checkpoints and review gates
grill-me	v1.0.0	Relentless Socratic interview to stress-test any plan or design
mckinsey-strategist	v2.1.0	Senior strategy consulting with SWOT, VRIO, 7S and First Principles analysis

🏛️ Software Architecture

Skill	Version	Purpose
senior-solution-architect	v2.1.0	Unified authority for C4 modeling, ADRs, and system reviews

🔬 Research & Analysis

Skill	Version	Purpose
deep-research	v2.2.0	Dense multi-step research workflow with sub-question decomposition, parallel agents, frontier-model recommendation, evidence ledger, citations, and confidence/gap analysis
us-program-research	v2.0.0	Structured US academic program research, ranking, and application action-plan generation
webpage-reader	v1.0.0	Extract clean Markdown from any URL using the Defuddle CLI. Supports metadata-only mode, batch URLs, and saving output to file

📝 Content Processing

Skill	Version	Purpose
youtube-summarizer	v2.1.0	Extract YouTube transcripts and generate comprehensive summaries
audio-transcriber	v2.1.0	Transform audio recordings into professional Markdown documentation
pptx-translator	v2.8.0	Translate PowerPoint presentations between languages with batched parallel translation, group shape support, and per-slide self-validation
document-converter	v1.0.0	Convert Office documents to PDF, perform PDF operations (merge, split, rotate, encrypt, OCR) using local free tools — LibreOffice, ghostscript, pdftk, tesseract, imagemagick
storytelling-expert	v2.0.0	Transform ideas into engaging narratives using 8 elite storytelling frameworks

🎯 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.

Tool	Type	Invocation Example	Path
Claude Code	CLI	/skill-name help me...	~/.claude/skills/
Gemini CLI	CLI	Use skill-name to...	~/.gemini/skills/
Codex CLI	CLI	Use skill-name to...	~/.codex/skills/
Antigravity	IDE	(Agent Mode) Use skill...	~/.gemini/antigravity/skills/
Cursor	IDE	@skill-name in Chat	~/.cursor/skills/
Copilot	Ext	(Paste skill content manually)	N/A
OpenCode	CLI	opencode run @skill-name	~/.agent/skills/
AdaL CLI	CLI	(Auto) Skills load on-demand	~/.adal/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

Command	Shortcut	Purpose
install	i	Install skills
list	ls	List installed skills
status	st	Show global install status + version differences
update	up	Smart update (outdated + missing skills)
uninstall	rm	Remove skills
doctor	doc	Check installation

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

Package	Skills	Focus	Install
claude-superskills	18	Core: orchestration, planning, research & content	npx claude-superskills
obsidian-superskills	6	Obsidian knowledge management	npx obsidian-superskills
career-superskills	20	Job search & career development	npx career-superskills
product-superskills	8	Product management & GTM strategy	npx product-superskills
design-superskills	9	UI/UX design, brand & diagrams	npx design-superskills
avanade-superskills	3	Avanade-branded content (private)	git clone [email protected]:ericgandrade/avanade-superskills.git

---

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