Skip to content

ericgandrade/claude-superskills

Repository files navigation

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

Version License Skills Platforms

🚀 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-v1.21.8.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 55 skills under the claude-superskills: namespace

/claude-superskills:skill-creator
/claude-superskills:deep-research
/claude-superskills:brainstorming
/claude-superskills:prompt-engineer
/claude-superskills:mckinsey-strategist
/claude-superskills:writing-plans
/claude-superskills:executing-plans
/claude-superskills:agent-skill-discovery
/claude-superskills:agent-skill-orchestrator
... (46 more)

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

✨ Features

  • 55 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

💼 Career & Professional Growth

Skill Version Purpose
resume-ats-optimizer v2.1.0 Optimize resumes for Applicant Tracking Systems
resume-bullet-writer v2.1.0 Transform weak bullets into achievement-focused statements
resume-tailor v2.1.0 Customize resume for specific job postings
resume-formatter v2.1.0 Ensure ATS-friendly formatting and clean scannable layouts
resume-quantifier v2.1.0 Add metrics and quantifiable results to resume bullets
resume-section-builder v2.1.0 Create targeted resume sections for different experience levels
resume-version-manager v2.1.0 Track and manage multiple resume versions during a job search
job-description-analyzer v2.1.0 Analyze job postings and calculate match scores
interview-prep-generator v2.1.0 Generate STAR stories and practice questions
linkedin-profile-optimizer v2.1.0 Optimize LinkedIn profile for recruiter searchability
salary-negotiation-prep v2.1.0 Research market rates and build negotiation strategy
tech-resume-optimizer v2.1.0 Optimize resumes for technical and PM roles
executive-resume-writer v2.1.0 Create C-suite and VP-level resumes emphasizing strategic leadership
cover-letter-generator v2.1.0 Create personalized cover letters from resume and job description
career-changer-translator v2.1.0 Translate skills from one industry to another
creative-portfolio-resume v2.1.0 Balance visual design with ATS compatibility for creative roles
academic-cv-builder v2.1.0 Build and format CVs for academic positions
offer-comparison-analyzer v2.1.0 Compare multiple job offers with total compensation analysis
portfolio-case-study-writer v2.1.0 Transform resume bullets into detailed portfolio case studies
reference-list-builder v2.1.0 Format professional references and prepare reference materials

🔍 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
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
product-architecture v2.0.0 Define scalable product architecture and modules

🚀 Startup & Venture

Skill Version Purpose
startup-growth-strategist v2.0.0 Integrated authority for market sizing, unit economics, and GTM
abx-strategy v2.1.0 Build Account-Based Everything (ABX) GTM strategies

📈 Product Management & Strategy

Skill Version Purpose
product-operating-model v2.0.0 Index and entry point for the Modern Product Operating Model
product-strategy v2.0.0 Build product strategy defining where to play and how to win
product-discovery v2.0.0 Run continuous discovery using OSTs, interviews, and assumption testing
product-architecture v2.0.0 Convert discovery opportunities into roadmaps and solution briefs
product-delivery v2.0.0 Ship, measure, and learn with staged rollouts and metrics hierarchies
product-leadership v2.0.0 Operate as Director or CPO managing portfolios and org design
ai-native-product v2.0.0 Build AI-native products with agency-control tradeoffs and eval strategies

🔬 Research & Analysis

Skill Version Purpose
deep-research v2.1.0 Multi-step research workflow with citations using native web tools (no Google API required)
us-program-research v2.0.0 Structured US academic program research, ranking, and application action-plan generation

📝 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
docling-converter v2.1.0 Convert PDF/Office/image documents to Markdown/JSON/HTML with optional OCR
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
pptx-translator v2.8.0 Translate PowerPoint presentations between languages with batched parallel translation (3 slides/batch), AI-native language classification, group shape support, per-slide self-validation, and interactive output filename choice (original + lang suffix, AI-translated name, or custom)
storytelling-expert v2.0.0 Transform ideas into engaging narratives using 8 elite storytelling frameworks
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
mermaid-diagram v1.0.0 Generate Mermaid diagram syntax from plain-language descriptions — flowchart, sequence, class, state, ER, mindmap, Gantt, and 5 more types
excalidraw-diagram v1.0.0 Create hand-drawn style diagrams in Excalidraw JSON format — architecture sketches, concept maps, user flows, C4 context, org charts

🗒️ Obsidian Knowledge Management

Skill Version Purpose
obsidian-markdown v1.0.0 Master Obsidian Flavored Markdown — wikilinks, embeds, callouts, frontmatter properties, block IDs, and all Obsidian-specific syntax extensions
obsidian-links v1.0.0 Create, validate, repair, and analyze wikilinks in Obsidian vaults. Broken link detection, orphan discovery, auto-linking, and MOC builder
obsidian-frontmatter v1.0.0 Create, validate, standardize, and repair YAML frontmatter properties — tags, aliases, dates, custom fields — for Dataview-compatible notes
obsidian-automation v1.0.0 Automate Obsidian vault tasks using the CLI, shell scripts, and Local REST API — batch note creation, bulk updates, and vault maintenance
obsidian-note-builder v1.0.0 Build complete, knowledge-graph-ready Obsidian notes from raw content with entity extraction, auto-wikilinks, and Zettelkasten atomicity
obsidian-canvas v1.0.0 Create freeform visual workspaces using Obsidian Canvas — hub-and-spoke, Kanban, and dashboard layouts as ready-to-save .canvas files

🎯 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

# Product Management & Strategy
npx claude-superskills --bundle product -y

# Career & Professional Growth
npx claude-superskills --bundle career -y

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

# Skill Developer (for creating custom skills)
npx claude-superskills --bundle developer -y

# Obsidian Knowledge Management
npx claude-superskills --bundle obsidian -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 (~/.github/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

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

🔒 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


Built with ❤️ by Eric Andrade

Version 1.22.0 | April 2026

🎁 Get Started

Choose a bundle that fits your workflow:

  • Essential - skill-creator, prompt-engineer
  • Content - youtube-summarizer, audio-transcriber, docling-converter, document-converter, pptx-translator, storytelling-expert
  • Planning - brainstorming, writing-plans, executing-plans, mckinsey-strategist
  • Product - abx-strategy, ai-native-product, product-strategy, and more
  • Career - resume-ats-optimizer, interview-prep, salary-negotiation, and more
  • Research - deep-research, us-program-research + discovery
  • Obsidian - obsidian-markdown, links, frontmatter, automation, note-builder, canvas
  • Developer - skill-creator for power users
  • All - Complete toolkit

See detailed comparison.

🛠️ Advanced Usage


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

About

55 Universal AI Skills for Claude Code, GitHub Copilot & 6 more platforms. Planning, orchestration, product strategy, career workflows, research, Obsidian knowledge management, document conversion — no API keys required.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors