design-superskills v1.0.1

Universal installer for the design-superskills library. Install 64 reusable AI skills across GitHub Copilot CLI, Claude Code, OpenAI Codex, OpenCode, Gemini CLI, Antigravity, Cursor IDE, and AdaL CLI from one command.

If Claude Desktop is detected, the installer can also generate a Claude Cowork plugin zip for manual upload.

Quick Start

# Interactive smart installation
npx design-superskills

# Auto smart update/install
npx design-superskills -y -q

# Install curated bundles
npx design-superskills --bundle essential -y
npx design-superskills --bundle content -y
npx design-superskills --bundle career -y

See Installation Guide for full setup and troubleshooting.

What It Does

1. Detects installed AI tools and IDEs.
2. Downloads the matching skills release into a local cache.
3. Compares installed skill versions with the current installer version.
4. Recommends smart updates for outdated or missing skills.
5. Copies skills into each platform's global skills directory.
6. If Claude Cowork is detected and selected, generates a plugin zip and prints manual upload instructions.

Installation is always global. Local repository scope is no longer supported.

Supported Platforms

• GitHub Copilot CLI: ~/.github/skills/
• Claude Code: ~/.claude/skills/
• OpenAI Codex: ~/.codex/skills/
• OpenCode: ~/.agent/skills/
• Gemini CLI: ~/.gemini/skills/
• Antigravity: ~/.gemini/antigravity/skills/
• Cursor IDE: ~/.cursor/skills/
• AdaL CLI: ~/.adal/skills/

Claude Cowork is supported as a packaging target, not as a direct copy target. The installer generates a zip for manual upload in Claude Desktop / Cowork.

Support status:

• macOS: detected and validated locally
• Windows: detection implemented with common install/data path heuristics, not yet validated end-to-end
• Linux: detection implemented with desktop-entry/config path heuristics, not yet validated end-to-end

Available Commands

• install, i - Install skills (default)
• list, ls - List installed skills
• status, st - Show installed status and version diff
• update, up - Smart update outdated and missing skills
• package-cowork, cowork - Generate a Claude Cowork plugin zip
• uninstall, rm - Remove installed skills
• doctor, doc - Check installation health

Options

• --bundle NAME - Install a curated bundle
• --search KEYWORD - Search for matching skills
• --list-bundles - Show available bundles
• --all, -a - Install for all detected platforms
• --yes, -y - Skip prompts
• --quiet, -q - Minimal output
• --help, -h - Show help
• --version, -v - Show version

Bundles

• essential - Core workflow skills for discovery, orchestration, planning, and prompt optimization
• planning - Pre-implementation design and structured execution
• research - Deep research and resource discovery
• content - YouTube, audio, document conversion, CloudConvert, and storytelling workflows
• product - Product strategy, discovery, architecture, delivery, leadership, and AI-native product work
• career - Resume, job search, interview, negotiation, and portfolio workflows
• developer - Skill creation workflows
• orchestration - Resource discovery and planning
• all - All 64 available skills

npx design-superskills --list-bundles

Search

npx design-superskills --search "planning"
npx design-superskills --search "resume"
npx design-superskills --search "research"

Example Commands

npx design-superskills
npx design-superskills -y -q
npx design-superskills --bundle essential -y
npx design-superskills up -y
npx design-superskills package-cowork
npx design-superskills status
npx design-superskills uninstall -y
npx design-superskills doctor

Notes

• The installer downloads skills from GitHub and caches them locally before copying them into platform directories.
• The installer compares installed skill versions with v1.21.7 and recommends updates automatically.
• Skills are authored in the repository skills/ directory only; platform directories are installation targets, not source directories.
• Claude Cowork updates are manual by design: generate the zip, remove the previous design-superskills plugin in Cowork, then upload the new zip.