Skip to content
Back to search

claude-superskills

MarketplaceWorks with Claude CodeGitHub

18 Universal AI Skills for Claude Code, GitHub Copilot & 6 more platforms. Meta/orchestration, planning, research, and content — the focused core of the Superskills family.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ericgandrade/claude-superskills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ericgandrade/claude-superskills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ericgandrade--claude-superskills/badge.svg)](/listings/ericgandrade--claude-superskills)

HTML

<a href="/listings/ericgandrade--claude-superskills"><img src="/api/listings/ericgandrade--claude-superskills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**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](docs/INSTALLATION.md) for all methods and troubleshooting.

**Uninstall:**

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 48 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "claude-superskills",
  3. "owner": {
  4. "name": "Eric Andrade",
  5. "email": "egandrade@gmail.com"
  6. },
  7. "metadata": {
  8. "description": "18 universal AI skills for Claude Code — planning, orchestration, product strategy, career workflows, research, content processing, UI/UX design, Obsidian knowledge management, document conversion, and Avanade-branded web generation"
  9. },
  10. "plugins": [
  11. {
  12. "name": "claude-superskills",
  13. "source": {
  14. "source": "github",
  15. "repo": "ericgandrade/claude-superskills"
  16. },
  17. "description": "18 universal AI skills for Claude Code — planning, orchestration, product strategy, career workflows, research, content processing, UI/UX design, Obsidian knowledge management, document conversion, and Avanade-branded web generation",
  18. "author": {
  19. "name": "Eric Andrade"
  20. },
  21. "homepage": "https://github.com/ericgandrade/claude-superskills",
  22. "repository": "https://github.com/ericgandrade/claude-superskills",
  23. "license": "MIT",
  24. "keywords": [
  25. "skills",
  26. "ai",
  27. "automation",
  28. "research",
  29. "planning",
  30. "orchestration",
  31. "content",
  32. "strategy",
  33. "prompt-engineering",
  34. "ui-ux",
  35. "design"
  36. ],
  37. "category": "productivity",
  38. "tags": [
  39. "skills",
  40. "research",
  41. "planning",
  42. "content",
  43. "orchestration",
  44. "design"
  45. ]
  46. }
  47. ]
  48. }
README.md · README · 439 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🤖 Claude Superskills v2.0.8
  2. 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.
  3. ![Version](https://img.shields.io/badge/version-2.0.8-blue.svg)
  4. ![License](https://img.shields.io/badge/license-MIT-green.svg)
  5. ![Skills](https://img.shields.io/badge/skills-18-brightgreen.svg)
  6. ![Platforms](https://img.shields.io/badge/platforms-8-orange.svg)
  7. ## 🚀 Quick Install
  8. **One-liner (recommended):**
  9. ```bash
  10. curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 14 on GitHub
  11. ```
  12. **Or use NPX (zero-install):**
  13. ```bash
  14. npx claude-superskills
  15. ```
  16. 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.
  17. **Other methods:**
  18. ```bash
  19. # npm global
  20. npm install -g claude-superskills
  21. # With bundles
  22. npx claude-superskills --bundle essential -y
  23. ```
  24. **Local install (no npm/npx required):**
  25. If you have cloned the repository and want to install skills directly, without any internet download or Node.js:
  26. ```bash
  27. git clone https://github.com/ericgandrade/claude-superskills
  28. cd claude-superskills
  29. # Interactive — choose which platforms to install to
  30. ./scripts/local-install.sh
  31. # Auto-install to all detected platforms
  32. ./scripts/local-install.sh -y
  33. # Silent auto-install (CI / scripted environments)
  34. ./scripts/local-install.sh -y -q
  35. ```
  36. The script reads directly from `skills/`, detects your installed platforms, and copies everything into the right directories. No Node.js, no npm, no internet.
  37. See [Installation Guide](docs/INSTALLATION.md) for all methods and troubleshooting.
  38. **Uninstall:**
  39. ```bash
  40. curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/uninstall.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 56 on GitHub
  41. ```
  42. ## 🔌 Claude Code Plugin (Native)
  43. Use claude-superskills as a native Claude Code plugin — no npm, no Node.js required.
  44. Requires **Claude Code v1.0.33+** (`claude --version` to check).
  45. ---
  46. ### Option A — Claude Code CLI (Terminal)
  47. > ⚠️ **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.
  48. **Method 1: Interactive UI (Inside a running `claude` session) — Recommended**
  49. Start a Claude Code session:
  50. ```bash
  51. claude
  52. ```
  53. Then run these slash commands inside the session:
  54. ```text
  55. # 1. Add the marketplace
  56. /plugin marketplace add ericgandrade/claude-superskills
  57. # 2. Install the plugin
  58. /plugin install claude-superskills@claude-superskills
  59. ```
  60. Alternatively, open the plugin manager with `/plugin` → navigate to the **Discover** tab → search for "claude-superskills" → press **Enter** → choose your preferred scope.
  61. **Method 2: Shell command (Outside a session)**
  62. > 🐛 **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](https://github.com/anthropics/claude-code/issues/29722).
  63. ```bash
  64. # Attempt to add marketplace + install in one flow (Currently unstable)
  65. claude plugin install claude-superskills@claude-superskills
  66. ```
  67. Choose your scope with `--scope`:
  68. ```bash
  69. claude plugin install claude-superskills@claude-superskills --scope user # all your projects (default)
  70. claude plugin install claude-superskills@claude-superskills --scope project # team-shared via .claude/settings.json
  71. claude plugin install claude-superskills@claude-superskills --scope local # this project only, gitignored
  72. ```
  73. **Method 3: Local test (no install needed)**
  74. ```bash
  75. git clone https://github.com/ericgandrade/claude-superskills
  76. claude --plugin-dir ./claude-superskills
  77. ```
  78. ---
  79. ### Option B — Claude.ai Web (claude.ai)
  80. 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:
  81. > **Settings → Extensions → Browse Plugins** on [claude.ai](https://claude.ai)
  82. To be notified when the plugin is available on claude.ai, watch this repository.
  83. ---
  84. ### Option C — Claude Desktop Cowork (Custom Plugin Upload)
  85. 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.
  86. Generate the package with the installer:
  87. ```bash
  88. npx claude-superskills package-cowork
  89. ```
  90. Or let the interactive installer detect Cowork and offer it as a packaging target:
  91. ```bash
  92. npx claude-superskills
  93. ```
  94. The installer will generate a zip like:
  95. ```text
  96. ~/.claude-superskills/plugin-output/claude-superskills-v2.0.3.zip
  97. ```
  98. Then update Cowork manually:
  99. 1. Open Claude Desktop.
  100. 2. Switch to `Cowork`.
  101. 3. Open `Customize`.
  102. 4. Find the existing `claude-superskills` plugin.
  103. 5. Remove the previous version first.
  104. 6. Upload the new zip generated by the installer.
  105. 7. Confirm the new version appears in Cowork.
  106. Important:
  107. - The historical `claude plugin install` bug affects the GitHub/CLI install flow, not the Cowork custom zip upload flow.
  108. - Cowork is treated as `package + manual upload`, not as an auto-installed `~/.claude/skills/` target.
  109. - 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.
  110. ---
  111. ### Once installed — all 18 skills under the `claude-superskills:` namespace
  112. ```
  113. /claude-superskills:skill-creator
  114. /claude-superskills:prompt-engineer
  115. /claude-superskills:brainstorming
  116. /claude-superskills:writing-plans
  117. /claude-superskills:executing-plans
  118. /claude-superskills:grill-me
  119. /claude-superskills:mckinsey-strategist
  120. /claude-superskills:deep-research
  121. /claude-superskills:us-program-research
  122. /claude-superskills:webpage-reader
  123. /claude-superskills:senior-solution-architect
  124. /claude-superskills:agent-skill-discovery
  125. /claude-superskills:agent-skill-orchestrator
  126. /claude-superskills:youtube-summarizer
  127. /claude-superskills:audio-transcriber
  128. /claude-superskills:pptx-translator
  129. /claude-superskills:document-converter
  130. /claude-superskills:storytelling-expert
  131. ```
  132. > **npm install still works** for GitHub Copilot, Cursor IDE, Gemini CLI, and 5 other platforms. The plugin format is Claude Code-specific.
  133. ## ✨ Features
  134. - **18 Universal Skills** - Work on all platforms
  135. - **Zero-Config Install** - Run once, works everywhere
  136. - **Curated Bundles** - Install exactly what you need
  137. - **Smart Search** - Find skills by keyword
  138. - **8 Platform Support** - GitHub Copilot, Claude Code, Codex, OpenCode, Gemini, Antigravity, Cursor, AdaL
  139. - **Discovery & Orchestration** - Find and plan with available resources
  140. - **Command Shortcuts** - `i`, `ls`, `up`, `rm`, `doc`
  141. - **Short Flags** - `-a`, `-y`, `-q`
  142. ## 📦 Available Skills
  143. ### 🔍 Discovery & Orchestration
  144. | Skill | Version | Purpose |
  145. |-------|---------|---------|
  146. | **agent-skill-discovery** | v2.1.0 | Scan installed resources and current repository resources (agents, skills, MCPs) |
  147. | **agent-skill-orchestrator** | v2.1.0 | Intelligent task planning with automatic prompt optimization and resource matching |
  148. ### 🛠️ Development & Automation
  149. | Skill | Version | Purpose |
  150. |-------|---------|---------|
  151. | **skill-creator** | v2.1.0 | Automate skill creation with guided workflow |
  152. | **prompt-engineer** | v2.0.0 | Optimize prompts using 11 frameworks (RTF, RISEN, Chain of Thought, etc.) |
  153. ### 🧭 Planning & Execution
  154. | Skill | Version | Purpose |
  155. |-------|---------|---------|
  156. | **brainstorming** | v2.0.0 | Mandatory pre-implementation design clarification workflow |
  157. | **writing-plans** | v2.0.0 | Build detailed, actionable implementation plans before coding |
  158. | **executing-plans** | v2.0.0 | Execute plans in batches with checkpoints and review gates |
  159. | **grill-me** | v1.0.0 | Relentless Socratic interview to stress-test any plan or design |
  160. | **mckinsey-strategist** | v2.1.0 | Senior strategy consulting with SWOT, VRIO, 7S and First Principles analysis |
  161. ### 🏛️ Software Architecture
  162. | Skill | Version | Purpose |
  163. |-------|---------|---------|
  164. | **senior-solution-architect** | v2.1.0 | Unified authority for C4 modeling, ADRs, and system reviews |
  165. ### 🔬 Research & Analysis
  166. | Skill | Version | Purpose |
  167. |-------|---------|---------|
  168. | **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 |
  169. | **us-program-research** | v2.0.0 | Structured US academic program research, ranking, and application action-plan generation |
  170. | **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 |
  171. ### 📝 Content Processing
  172. | Skill | Version | Purpose |
  173. |-------|---------|---------|
  174. | **youtube-summarizer** | v2.1.0 | Extract YouTube transcripts and generate comprehensive summaries |
  175. | **audio-transcriber** | v2.1.0 | Transform audio recordings into professional Markdown documentation |
  176. | **pptx-translator** | v2.8.0 | Translate PowerPoint presentations between languages with batched parallel translation, group shape support, and per-slide self-validation |
  177. | **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 |
  178. | **storytelling-expert** | v2.0.0 | Transform ideas into engaging narratives using 8 elite storytelling frameworks |
  179. ## 🎯 Curated Bundles
  180. ```bash
  181. # Essential Skills (recommended for beginners)
  182. npx claude-superskills --bundle essential -y
  183. # Content Creation (video & audio)
  184. npx claude-superskills --bundle content -y
  185. # Planning & Execution
  186. npx claude-superskills --bundle planning -y
  187. # Research & Analysis
  188. npx claude-superskills --bundle research -y
  189. # Discovery & Orchestration
  190. npx claude-superskills --bundle orchestration -y
  191. # All Skills (complete collection)
  192. npx claude-superskills --bundle all -y
  193. ```
  194. See [Bundles Guide](docs/bundles/bundles.md) for details.
  195. ## 🔍 Search Skills
  196. ```bash
  197. npx claude-superskills --search "prompt"
  198. npx claude-superskills --search "video"
  199. ```
  200. ## 🚀 Quick Start Examples
  201. ### Discovery & Planning Workflow
  202. ```bash
  203. # 1. Discover what's available
  204. claude # or: gh copilot, gemini, opencode, codex
  205. > "What do I have installed?"
  206. # Output: Lists installed and current-repository plugins, skills, MCPs
  207. # 2. Get intelligent execution plan
  208. > "Plan how to build a REST API with authentication"
  209. # Output: Detailed strategy using best available resources with confidence scores
  210. ```
  211. ### Other Use Cases
  212. ```bash
  213. # Create a new skill
  214. gh copilot -p "create a skill for PDF processing"
  215. # Optimize a prompt
  216. claude -p "improve this prompt: create REST API"
  217. # Process content
  218. gh copilot -p "transcribe this audio file: meeting.mp3"
  219. # Orchestrate complex tasks
  220. gemini -p "design a solution for processing meeting notes and creating Jira tickets"
  221. ```
  222. ## 💻 Supported Platforms
  223. - **GitHub Copilot CLI** - Terminal AI assistant (`~/.copilot/skills/`)
  224. - **Claude Code** - Anthropic's Claude in development (`~/.claude/skills/`)
  225. - **OpenAI Codex** - GPT-powered coding assistant (`~/.codex/skills/`)
  226. - **OpenCode** - Open source AI coding assistant (`~/.agent/skills/`)
  227. - **Gemini CLI** - Google's Gemini in terminal (`~/.gemini/skills/`)
  228. - **Antigravity** - AI coding assistant (`~/.gemini/antigravity/skills/`)
  229. - **Cursor IDE** - AI-powered code editor (`~/.cursor/skills/`)
  230. - **AdaL CLI** - AI development assistant (`~/.adal/skills/`)
  231. **Note on Codex:** The installer uses `~/.codex/skills/` for Codex CLI + App, with cleanup support for legacy `~/.agents/skills/`.
  232. ## ⌨️ Compatibility & Invocation
  233. These skills follow the universal `SKILL.md` format and work with any AI coding assistant that supports agentic skills.
  234. | Tool | Type | Invocation Example | Path |
  235. |------|------|--------------------|------|
  236. | **Claude Code** | CLI | `/skill-name help me...` | `~/.claude/skills/` |
  237. | **Gemini CLI** | CLI | `Use skill-name to...` | `~/.gemini/skills/` |
  238. | **Codex CLI** | CLI | `Use skill-name to...` | `~/.codex/skills/` |
  239. | **Antigravity** | IDE | *(Agent Mode)* `Use skill...` | `~/.gemini/antigravity/skills/` |
  240. | **Cursor** | IDE | `@skill-name` in Chat | `~/.cursor/skills/` |
  241. | **Copilot** | Ext | *(Paste skill content manually)* | N/A |
  242. | **OpenCode** | CLI | `opencode run @skill-name` | `~/.agent/skills/` |
  243. | **AdaL CLI** | CLI | *(Auto)* Skills load on-demand | `~/.adal/skills/` |
  244. > **Tip:** OpenCode uses `~/.agent/skills/`; Antigravity uses `~/.gemini/antigravity/skills/`.
  245. ## 📚 Documentation
  246. - **[Getting Started](docs/guides/getting-started.md)** - First-time user guide
  247. - **[Skill Anatomy](docs/guides/skill-anatomy.md)** - How skills work
  248. - **[Bundles Guide](docs/bundles/bundles.md)** - Curated collections
  249. - **[Quality Standards](docs/guides/quality-standards.md)** - Best practices
  250. - **[Full Catalog](CATALOG.md)** - Complete skill listing
  251. ## ⚡ CLI Commands & Shortcuts
  252. | Command | Shortcut | Purpose |
  253. |---------|----------|---------|
  254. | `install` | `i` | Install skills |
  255. | `list` | `ls` | List installed skills |
  256. | `status` | `st` | Show global install status + version differences |
  257. | `update` | `up` | Smart update (outdated + missing skills) |
  258. | `uninstall` | `rm` | Remove skills |
  259. | `doctor` | `doc` | Check installation |
  260. ```bash
  261. npx claude-superskills i -a -y -q # Install all, skip prompts, quiet mode
  262. npx claude-superskills status # Show global status + skill version differences
  263. npx claude-superskills up -y # Update outdated + install missing skills
  264. npx claude-superskills ls -q # List with minimal output
  265. npx claude-superskills --list-bundles # Show available bundles
  266. ```
  267. ## 📋 System Requirements
  268. - Node.js 14+ (for installer)
  269. - One or more supported platforms installed
  270. - Python 3.8+ (for some skills with dependencies)
  271. ## 🤝 Contributing
  272. We welcome contributions! Check [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
  273. - Create new skills using the [skill-creator](https://github.com/ericgandrade/claude-superskills) skill
  274. - Follow [Quality Standards](docs/guides/quality-standards.md)
  275. - Report issues and suggestions
  276. ## 🔒 Privacy
  277. claude-superskills does not collect, store, transmit, or share any user data.
  278. - **No external servers** — the plugin has no backend, no telemetry, and no network requests of its own
  279. - **No API keys required** — all skills run entirely within Claude Code using Claude's native tools (WebSearch, WebFetch, Bash, Read/Write)
  280. - **No logging** — nothing is recorded outside of your local Claude Code session
  281. - **Open source** — all skill logic is fully auditable at [github.com/ericgandrade/claude-superskills](https://github.com/ericgandrade/claude-superskills)
  282. Any web searches or document fetches performed by skills use Claude Code's built-in tools, subject to Anthropic's own privacy policy.
  283. ## 📄 License
  284. MIT - See [LICENSE](./LICENSE) for details.
  285. ## 🔗 Quick Links
  286. - 📚 [Full Catalog](CATALOG.md) - All skills with metadata
  287. - 🛠️ [Skills Development Guide](docs/references/skills-development.md) - Create custom skills
  288. - 📝 [Changelog](CHANGELOG.md) - Release history
  289. - 🐛 [Issues](https://github.com/ericgandrade/claude-superskills/issues) - Report problems
  290. - 💬 [Discussions](https://github.com/ericgandrade/claude-superskills/discussions) - Share ideas
  291. ---
  292. **Built with ❤️ by [Eric Andrade](https://github.com/ericgandrade)**
  293. *Version 2.0.8 | May 2026*
  294. ## 🎁 Get Started
  295. Choose a bundle that fits your workflow:
  296. - **[Essential](docs/bundles/bundles.md#-essential-bundle)** - skill-creator, prompt-engineer, agent-skill-discovery, agent-skill-orchestrator
  297. - **[Planning](docs/bundles/bundles.md#-planning--execution-bundle)** - brainstorming, writing-plans, executing-plans, grill-me, mckinsey-strategist, agent-skill-orchestrator
  298. - **[Research](docs/bundles/bundles.md#-research--analysis-bundle)** - deep-research, us-program-research, agent-skill-discovery, prompt-engineer
  299. - **[Content](docs/bundles/bundles.md#-content-creation-bundle)** - youtube-summarizer, audio-transcriber, pptx-translator, document-converter, storytelling-expert
  300. - **[Orchestration](docs/bundles/bundles.md#-orchestration-bundle)** - agent-skill-discovery, agent-skill-orchestrator
  301. - **[All](docs/bundles/bundles.md#-all-skills-bundle)** - Complete 18-skill toolkit
  302. See [detailed comparison](docs/bundles/bundles.md#-bundle-comparison).
  303. ## 🛠️ Advanced Usage
  304. - **[Skill Anatomy](docs/guides/skill-anatomy.md)** - How to build skills
  305. - **[Skills Development](docs/references/skills-development.md)** - Advanced creation
  306. - **[Changelog](CHANGELOG.md)** - Version history
  307. ## Part of the Superskills Family
  308. | Package | Skills | Focus | Install |
  309. |---------|--------|-------|---------|
  310. | **claude-superskills** | 18 | Core: orchestration, planning, research & content | `npx claude-superskills` |
  311. | [obsidian-superskills](https://github.com/ericgandrade/obsidian-superskills) | 6 | Obsidian knowledge management | `npx obsidian-superskills` |
  312. | [career-superskills](https://github.com/ericgandrade/career-superskills) | 20 | Job search & career development | `npx career-superskills` |
  313. | [product-superskills](https://github.com/ericgandrade/product-superskills) | 8 | Product management & GTM strategy | `npx product-superskills` |
  314. | [design-superskills](https://github.com/ericgandrade/design-superskills) | 9 | UI/UX design, brand & diagrams | `npx design-superskills` |
  315. | [avanade-superskills](https://github.com/ericgandrade/avanade-superskills) | 3 | Avanade-branded content (private) | `git clone git@github.com:ericgandrade/avanade-superskills.git` |
  316. ---
  317. **Getting Started? Check [Quick Start](docs/guides/getting-started.md) or run `npx claude-superskills` now!**
scripts/install.sh · Bundled script · 581 lines · 6 findings marked
  1. #!/usr/bin/env bash
  2. #
  3. # CLI AI Skills Installer
  4. # https://github.com/ericgandrade/claude-superskills
  5. #
  6. # Usage:
  7. # curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 7 on GitHub
  8. # wget -qO- https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 8 on GitHub
  9. #
  10. # Options:
  11. # --yes, -y Skip all confirmations
  12. # --skip-node-check Skip Node.js version verification
  13. # --verbose Show detailed output
  14. # --help, -h Show this help message
  15. # --version, -v Show installer version
  16. set -euo pipefail
  17. # Installer version
  18. INSTALLER_VERSION="1.0.0"
  19. # Configuration
  20. MIN_NODE_VERSION="16.0.0"
  21. PACKAGE_NAME="claude-superskills"
  22. REPO_URL="https://github.com/ericgandrade/claude-superskills"
  23. # Flags
  24. SKIP_CONFIRMATION=false
  25. SKIP_NODE_CHECK=false
  26. VERBOSE=false
  27. # Colors
  28. if [[ -t 1 ]]; then
  29. GREEN='\033[0;32m'
  30. RED='\033[0;31m'
  31. YELLOW='\033[1;33m'
  32. BLUE='\033[0;34m'
  33. CYAN='\033[0;36m'
  34. BOLD='\033[1m'
  35. NC='\033[0m'
  36. else
  37. GREEN=''
  38. RED=''
  39. YELLOW=''
  40. BLUE=''
  41. CYAN=''
  42. BOLD=''
  43. NC=''
  44. fi
  45. # Cleanup on exit
  46. cleanup() {
  47. local exit_code=$?
  48. if [[ $exit_code -ne 0 ]]; then
  49. print_error "Installation failed with exit code $exit_code"
  50. fi
  51. }
  52. trap cleanup EXIT INT TERM
  53. # Print functions
  54. print_success() {
  55. echo -e "${GREEN}✓${NC} $1"
  56. }
  57. print_error() {
  58. echo -e "${RED}✗${NC} $1" >&2
  59. }
  60. print_info() {
  61. echo -e "${BLUE}ℹ${NC} $1"
  62. }
  63. print_warning() {
  64. echo -e "${YELLOW}⚠${NC} $1"
  65. }
  66. print_step() {
  67. echo -e "\n${BOLD}${CYAN}▸${NC} $1"
  68. }
  69. verbose() {
  70. if [[ "$VERBOSE" == "true" ]]; then
  71. echo -e "${CYAN}[DEBUG]${NC} $1"
  72. fi
  73. }
  74. # Show help
  75. show_help() {
  76. cat << EOF
  77. ${BOLD}CLI AI Skills Installer${NC} v${INSTALLER_VERSION}
  78. ${BOLD}USAGE:${NC}
  79. curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 93 on GitHub
  80. wget -qO- https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 94 on GitHub
  81. ${BOLD}OPTIONS:${NC}
  82. -y, --yes Skip all confirmations (non-interactive mode)
  83. --skip-node-check Skip Node.js version verification
  84. --verbose Show detailed output
  85. -h, --help Show this help message
  86. -v, --version Show installer version
  87. ${BOLD}EXAMPLES:${NC}
  88. # Interactive install
  89. curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 105 on GitHub
  90. # Non-interactive (CI/CD)
  91. curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash -s -- --yes
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 108 on GitHub
  92. ${BOLD}REQUIREMENTS:${NC}
  93. - Node.js >= ${MIN_NODE_VERSION}
  94. - npm (comes with Node.js)
  95. - macOS, Linux, or WSL
  96. ${BOLD}MORE INFO:${NC}
  97. ${REPO_URL}
  98. EOF
  99. }
  100. # Parse arguments
  101. parse_args() {
  102. while [[ $# -gt 0 ]]; do
  103. case $1 in
  104. -y|--yes)
  105. SKIP_CONFIRMATION=true
  106. shift
  107. ;;
  108. --skip-node-check)
  109. SKIP_NODE_CHECK=true
  110. shift
  111. ;;
  112. --verbose)
  113. VERBOSE=true
  114. shift
  115. ;;
  116. -h|--help)
  117. show_help
  118. exit 0
  119. ;;
  120. -v|--version)
  121. echo "CLI AI Skills Installer v${INSTALLER_VERSION}"
  122. exit 0
  123. ;;
  124. *)
  125. print_error "Unknown option: $1"
  126. echo "Use --help for usage information"
  127. exit 1
  128. ;;
  129. esac
  130. done
  131. }
  132. # Detect operating system
  133. detect_os() {
  134. verbose "Detecting operating system..."
  135. local os=""
  136. case "$(uname -s)" in
  137. Darwin*)
  138. os="macos"
  139. verbose "Detected: macOS"
  140. ;;
  141. Linux*)
  142. if grep -qi microsoft /proc/version 2>/dev/null; then
  143. os="wsl"
  144. verbose "Detected: WSL (Windows Subsystem for Linux)"
  145. else
  146. os="linux"
  147. verbose "Detected: Linux"
  148. fi
  149. ;;
  150. CYGWIN*|MINGW*|MSYS*)
  151. os="windows"
  152. verbose "Detected: Windows (Git Bash/MSYS)"
  153. ;;
  154. *)
  155. os="unsupported"
  156. verbose "Detected: Unknown/Unsupported OS"
  157. ;;
  158. esac
  159. echo "$os"
  160. }
  161. # Version comparison (semver)
  162. version_compare() {
  163. local version1=$1
  164. local version2=$2
  165. # Remove 'v' prefix if present
  166. version1=${version1#v}
  167. version2=${version2#v}
  168. # Split versions into arrays
  169. IFS='.' read -ra ver1 <<< "$version1"
  170. IFS='.' read -ra ver2 <<< "$version2"
  171. # Compare major.minor.patch
  172. for i in 0 1 2; do
  173. local v1=${ver1[$i]:-0}
  174. local v2=${ver2[$i]:-0}
  175. if (( v1 > v2 )); then
  176. return 0 # version1 > version2
  177. elif (( v1 < v2 )); then
  178. return 1 # version1 < version2
  179. fi
  180. done
  181. return 0 # versions are equal
  182. }
  183. # Check if Node.js is installed and meets minimum version
  184. check_node_installed() {
  185. verbose "Checking Node.js installation..."
  186. if ! command -v node &> /dev/null; then
  187. verbose "Node.js not found in PATH"
  188. return 1
  189. fi
  190. local node_version
  191. node_version=$(node --version 2>/dev/null || echo "v0.0.0")
  192. verbose "Found Node.js $node_version"
  193. if version_compare "$node_version" "$MIN_NODE_VERSION"; then
  194. verbose "Node.js version is sufficient (>= $MIN_NODE_VERSION)"
  195. return 0
  196. else
  197. verbose "Node.js version is too old (< $MIN_NODE_VERSION)"
  198. return 1
  199. fi
  200. }
  201. # Offer to install Node.js via nvm
  202. install_with_nvm() {
  203. print_step "Node.js Installation Required"
  204. echo "Node.js >= ${MIN_NODE_VERSION} is required but not found."
  205. echo ""
  206. if command -v nvm &> /dev/null; then
  207. print_info "nvm is already installed"
  208. echo ""
  209. echo "You can install Node.js with:"
  210. echo " ${CYAN}nvm install --lts${NC}"
  211. echo " ${CYAN}nvm use --lts${NC}"
  212. echo ""
  213. if [[ "$SKIP_CONFIRMATION" == "false" ]]; then
  214. read -p "Would you like to install Node.js now? [y/N] " -n 1 -r
  215. echo
  216. if [[ $REPLY =~ ^[Yy]$ ]]; then
  217. nvm install --lts
  218. nvm use --lts
  219. print_success "Node.js installed successfully"
  220. return 0
  221. fi
  222. fi
  223. else
  224. print_warning "nvm (Node Version Manager) is not installed"
  225. echo ""
  226. echo "To install Node.js, you can:"
  227. echo ""
  228. echo "1. Install nvm (recommended):"
  229. echo " ${CYAN}curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash${NC}"
  230. echo " Then run: ${CYAN}nvm install --lts${NC}"
  231. echo ""
  232. echo "2. Download from nodejs.org:"
  233. echo " ${CYAN}https://nodejs.org/${NC}"
  234. echo ""
  235. echo "3. Use a package manager:"
  236. echo " macOS: ${CYAN}brew install node${NC}"
  237. echo " Ubuntu: ${CYAN}sudo apt install nodejs npm${NC}"
  238. echo ""
  239. fi
  240. print_error "Please install Node.js and run this script again"
  241. exit 1
  242. }
  243. # Detect installed AI tools
  244. detect_ai_tools() {
  245. verbose "Detecting AI CLI tools..."
  246. local tools=()
  247. # GitHub Copilot CLI
  248. if command -v gh &> /dev/null && gh copilot --version &> /dev/null; then
  249. local gh_version=$(gh copilot --version 2>/dev/null | head -1 || echo "unknown")
  250. tools+=("copilot:installed:$gh_version")
  251. verbose "Found: GitHub Copilot CLI ($gh_version)"
  252. else
  253. tools+=("copilot:not_installed:-")
  254. verbose "Not found: GitHub Copilot CLI"
  255. fi
  256. # Claude Code
  257. if [[ -d "$HOME/.claude" ]]; then
  258. tools+=("claude:installed:unknown")
  259. verbose "Found: Claude Code (directory exists)"
  260. else
  261. tools+=("claude:not_installed:-")
  262. verbose "Not found: Claude Code"
  263. fi
  264. # Codex
  265. if [[ -d "$HOME/.codex" ]]; then
  266. tools+=("codex:installed:unknown")
  267. verbose "Found: Codex (directory exists)"
  268. else
  269. tools+=("codex:not_installed:-")
  270. verbose "Not found: Codex"
  271. fi
  272. # OpenCode
  273. if command -v opencode &> /dev/null; then
  274. local oc_version=$(opencode --version 2>/dev/null || echo "unknown")
  275. tools+=("opencode:installed:$oc_version")
  276. verbose "Found: OpenCode ($oc_version)"
  277. else
  278. tools+=("opencode:not_installed:-")
  279. verbose "Not found: OpenCode"
  280. fi
  281. # Gemini CLI
  282. if command -v gemini &> /dev/null; then
  283. local gem_version=$(gemini --version 2>/dev/null || echo "unknown")
  284. tools+=("gemini:installed:$gem_version")
  285. verbose "Found: Gemini CLI ($gem_version)"
  286. else
  287. tools+=("gemini:not_installed:-")
  288. verbose "Not found: Gemini CLI"
  289. fi
  290. # Antigravity
  291. if command -v antigravity &> /dev/null || command -v agy &> /dev/null \
  292. || [[ -d "$HOME/.gemini/antigravity/skills" ]]; then
  293. tools+=("antigravity:installed:unknown")
  294. verbose "Found: Antigravity"
  295. else
  296. tools+=("antigravity:not_installed:-")
  297. verbose "Not found: Antigravity"
  298. fi
  299. # Cursor IDE
  300. if command -v cursor &> /dev/null || [[ -d "/Applications/Cursor.app" ]] \
  301. || [[ -d "$HOME/.cursor/skills" ]]; then
  302. tools+=("cursor:installed:unknown")
  303. verbose "Found: Cursor IDE"
  304. else
  305. tools+=("cursor:not_installed:-")
  306. verbose "Not found: Cursor IDE"
  307. fi
  308. # AdaL CLI
  309. if command -v adal &> /dev/null || [[ -d "$HOME/.adal/skills" ]]; then
  310. tools+=("adal:installed:unknown")
  311. verbose "Found: AdaL CLI"
  312. else
  313. tools+=("adal:not_installed:-")
  314. verbose "Not found: AdaL CLI"
  315. fi
  316. # Return as newline-delimited
  317. printf "%s\n" "${tools[@]}"
  318. }
  319. # Display tools table
  320. display_tools_table() {
  321. local tools=("$@")
  322. echo ""
  323. echo "┌────────────────────────────────────────────────────────┐"
  324. echo "│ AI CLI Tools Detection │"
  325. echo "├────────────────────────┬────────┬──────────────────────┤"
  326. echo "│ Tool │ Status │ Version │"
  327. echo "├────────────────────────┼────────┼──────────────────────┤"
  328. for tool_info in "${tools[@]}"; do
  329. IFS=':' read -r name status version <<< "$tool_info"
  330. local display_name=""
  331. case "$name" in
  332. copilot) display_name="GitHub Copilot CLI" ;;
  333. claude) display_name="Claude Code" ;;
  334. codex) display_name="Codex" ;;
  335. opencode) display_name="OpenCode" ;;
  336. gemini) display_name="Gemini CLI" ;;
  337. antigravity) display_name="Antigravity" ;;
  338. cursor) display_name="Cursor IDE" ;;
  339. adal) display_name="AdaL CLI" ;;
  340. esac
  341. local status_icon=""
  342. if [[ "$status" == "installed" ]]; then
  343. status_icon="${GREEN}✓${NC}"
  344. else
  345. status_icon="${RED}✗${NC}"
  346. fi
  347. printf "│ %-22s │ %-6s │ %-20s │\n" "$display_name" "$status_icon" "$version"
  348. done
  349. echo "└────────────────────────┴────────┴──────────────────────┘"
  350. echo ""
  351. }
  352. # Install claude-superskills
  353. install_cli_ai_skills() {
  354. print_step "Installing ${PACKAGE_NAME}..."
  355. verbose "Running: npm install -g ${PACKAGE_NAME}"
  356. if [[ "$VERBOSE" == "true" ]]; then
  357. npm install -g "${PACKAGE_NAME}"
  358. else
  359. npm install -g "${PACKAGE_NAME}" > /dev/null 2>&1
  360. fi
  361. if [[ $? -eq 0 ]]; then
  362. print_success "${PACKAGE_NAME} installed successfully"
  363. return 0
  364. else
  365. print_error "Failed to install ${PACKAGE_NAME}"
  366. return 1
  367. fi
  368. }
  369. # Verify installation
  370. verify_installation() {
  371. verbose "Verifying installation..."
  372. if command -v claude-superskills &> /dev/null; then
  373. local installed_version=$(claude-superskills --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "unknown")
  374. verbose "Installed version: $installed_version"
  375. print_success "Installation verified (v${installed_version})"
  376. return 0
  377. else
  378. print_error "Installation verification failed"
  379. return 1
  380. fi
  381. }
  382. # Show post-install instructions
  383. show_post_install() {
  384. local tools=("$@")
  385. echo ""
  386. echo "╔════════════════════════════════════════════════════════════════╗"
  387. echo "║ ${GREEN}✓${NC} ${BOLD}CLI AI Skills Installed Successfully!${NC} ║"
  388. echo "╚════════════════════════════════════════════════════════════════╝"
  389. echo ""
  390. print_step "Next Steps"
  391. echo ""
  392. echo "1. Run the installer:"
  393. echo " ${CYAN}claude-superskills${NC}"
  394. echo ""
  395. echo "2. Or use npx (no install needed):"
  396. echo " ${CYAN}npx claude-superskills${NC}"
  397. echo ""
  398. # Count installed tools
  399. local installed_count=0
  400. for tool_info in "${tools[@]}"; do
  401. IFS=':' read -r name status version <<< "$tool_info"
  402. if [[ "$status" == "installed" ]]; then
  403. ((installed_count++))
  404. fi
  405. done
  406. if [[ $installed_count -gt 0 ]]; then
  407. print_info "Detected ${installed_count}/8 AI CLI tools on your system"
  408. echo " Skills will be installed for detected platforms"
  409. else
  410. print_warning "No AI CLI tools detected"
  411. echo " Install GitHub Copilot CLI, Claude Code, or others first"
  412. fi
  413. echo ""
  414. print_step "Documentation"
  415. echo " ${REPO_URL}"
  416. echo ""
  417. # Offer to run installer
  418. if [[ "$SKIP_CONFIRMATION" == "false" ]]; then
  419. echo ""
  420. read -p "Would you like to run the installer now? [y/N] " -n 1 -r
  421. echo
  422. if [[ $REPLY =~ ^[Yy]$ ]]; then
  423. echo ""
  424. exec claude-superskills
  425. fi
  426. fi
  427. }
  428. # Main installation flow
  429. main() {
  430. parse_args "$@"
  431. # Show banner
  432. echo ""
  433. echo "╔════════════════════════════════════════════════════════════════╗"
  434. echo "║ ${BOLD}CLI AI Skills Installer${NC} ║"
  435. echo "║ Universal skill library for AI CLI tools ║"
  436. echo "╚════════════════════════════════════════════════════════════════╝"
  437. echo ""
  438. # Detect OS
  439. print_step "Detecting Operating System"
  440. local os
  441. os=$(detect_os)
  442. case "$os" in
  443. macos)
  444. print_success "macOS detected"
  445. ;;
  446. linux)
  447. print_success "Linux detected"
  448. ;;
  449. wsl)
  450. print_success "WSL (Windows Subsystem for Linux) detected"
  451. ;;
  452. windows)
  453. print_error "Pure Windows is not supported"
  454. echo ""
  455. echo "Please use:"
  456. echo " • WSL (Windows Subsystem for Linux)"
  457. echo " • Git Bash (install via: npm install -g claude-superskills)"
  458. echo " • Or: npx claude-superskills"
  459. exit 1
  460. ;;
  461. *)
  462. print_error "Unsupported operating system"
  463. exit 1
  464. ;;
  465. esac
  466. # Check Node.js
  467. if [[ "$SKIP_NODE_CHECK" == "false" ]]; then
  468. print_step "Checking Node.js"
  469. if check_node_installed; then
  470. local node_version=$(node --version)
  471. print_success "Node.js ${node_version} installed"
  472. else
  473. install_with_nvm
  474. fi
  475. else
  476. print_warning "Skipping Node.js check (--skip-node-check)"
  477. fi
  478. # Detect AI tools
  479. print_step "Detecting AI CLI Tools"
  480. local tools_array=()
  481. while IFS= read -r line; do
  482. tools_array+=("$line")
  483. done < <(detect_ai_tools)
  484. display_tools_table "${tools_array[@]}"
  485. # Install package
  486. if ! install_cli_ai_skills; then
  487. exit 1
  488. fi
  489. # Verify installation
  490. if ! verify_installation; then
  491. exit 1
  492. fi
  493. # Show post-install
  494. show_post_install "${tools_array[@]}"
  495. }
  496. # Run main if executed directly (not sourced)
  497. if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
  498. main "$@"
  499. fi
scripts/uninstall.sh · Bundled script · 447 lines · 3 findings marked
  1. #!/usr/bin/env bash
  2. #
  3. # CLI AI Skills Uninstaller
  4. # https://github.com/ericgandrade/claude-superskills
  5. #
  6. # Usage:
  7. # bash uninstall.sh
  8. # curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/uninstall.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 8 on GitHub
  9. #
  10. # Options:
  11. # --yes, -y Skip all confirmations
  12. # --purge Remove all data including configurations
  13. # --dry-run Show what would be removed without removing
  14. # --help, -h Show this help message
  15. set -euo pipefail
  16. # Uninstaller version
  17. UNINSTALLER_VERSION="1.0.0"
  18. # Configuration
  19. PACKAGE_NAME="claude-superskills"
  20. # Flags
  21. SKIP_CONFIRMATION=false
  22. PURGE=false
  23. DRY_RUN=false
  24. # Colors
  25. if [[ -t 1 ]]; then
  26. GREEN='\033[0;32m'
  27. RED='\033[0;31m'
  28. YELLOW='\033[1;33m'
  29. BLUE='\033[0;34m'
  30. CYAN='\033[0;36m'
  31. BOLD='\033[1m'
  32. NC='\033[0m'
  33. else
  34. GREEN=''
  35. RED=''
  36. YELLOW=''
  37. BLUE=''
  38. CYAN=''
  39. BOLD=''
  40. NC=''
  41. fi
  42. # Print functions
  43. print_success() {
  44. echo -e "${GREEN}✓${NC} $1"
  45. }
  46. print_error() {
  47. echo -e "${RED}✗${NC} $1" >&2
  48. }
  49. print_info() {
  50. echo -e "${BLUE}ℹ${NC} $1"
  51. }
  52. print_warning() {
  53. echo -e "${YELLOW}⚠${NC} $1"
  54. }
  55. print_step() {
  56. echo -e "\n${BOLD}${CYAN}▸${NC} $1"
  57. }
  58. print_dry_run() {
  59. echo -e "${YELLOW}[DRY RUN]${NC} $1"
  60. }
  61. # Show help
  62. show_help() {
  63. cat << EOF
  64. ${BOLD}CLI AI Skills Uninstaller${NC} v${UNINSTALLER_VERSION}
  65. ${BOLD}USAGE:${NC}
  66. bash uninstall.sh [OPTIONS]
  67. curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/uninstall.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 80 on GitHub
  68. ${BOLD}OPTIONS:${NC}
  69. -y, --yes Skip all confirmations
  70. --purge Remove all data including configurations
  71. --dry-run Show what would be removed without removing
  72. -h, --help Show this help message
  73. ${BOLD}EXAMPLES:${NC}
  74. # Interactive uninstall
  75. bash uninstall.sh
  76. # Non-interactive
  77. bash uninstall.sh --yes
  78. # See what would be removed
  79. bash uninstall.sh --dry-run
  80. # Complete removal including configs
  81. bash uninstall.sh --yes --purge
  82. ${BOLD}WHAT GETS REMOVED:${NC}
  83. • npm global package (claude-superskills)
  84. • Installed skills in ~/.github/skills/
  85. • Installed skills in ~/.claude/skills/
  86. • Installed skills in ~/.codex/skills/
  87. • Installed skills in ~/.agent/skills/
  88. • Installed skills in ~/.gemini/skills/
  89. • Installed skills in ~/.gemini/antigravity/skills/
  90. • Installed skills in ~/.cursor/skills/
  91. • Installed skills in ~/.adal/skills/
  92. • (with --purge) Empty platform directories
  93. EOF
  94. }
  95. # Parse arguments
  96. parse_args() {
  97. while [[ $# -gt 0 ]]; do
  98. case $1 in
  99. -y|--yes)
  100. SKIP_CONFIRMATION=true
  101. shift
  102. ;;
  103. --purge)
  104. PURGE=true
  105. shift
  106. ;;
  107. --dry-run)
  108. DRY_RUN=true
  109. shift
  110. ;;
  111. -h|--help)
  112. show_help
  113. exit 0
  114. ;;
  115. *)
  116. print_error "Unknown option: $1"
  117. echo "Use --help for usage information"
  118. exit 1
  119. ;;
  120. esac
  121. done
  122. }
  123. # Check if package is installed
  124. check_package_installed() {
  125. if npm list -g "${PACKAGE_NAME}" &> /dev/null; then
  126. return 0
  127. else
  128. return 1
  129. fi
  130. }
  131. # Find installed skills in platform directories
  132. find_installed_skills() {
  133. local platform_dirs=(
  134. "$HOME/.github/skills"
  135. "$HOME/.claude/skills"
  136. "$HOME/.codex/skills"
  137. "$HOME/.agent/skills"
  138. "$HOME/.gemini/skills"
  139. "$HOME/.gemini/antigravity/skills"
  140. "$HOME/.cursor/skills"
  141. "$HOME/.adal/skills"
  142. )
  143. local found_skills=()
  144. for dir in "${platform_dirs[@]}"; do
  145. if [[ -d "$dir" ]]; then
  146. while IFS= read -r -d '' skill_dir; do
  147. local skill_name=$(basename "$skill_dir")
  148. local platform=$(basename "$(dirname "$dir")")
  149. found_skills+=("$platform:$skill_name:$skill_dir")
  150. done < <(find "$dir" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null || true)
  151. fi
  152. done
  153. printf "%s\n" "${found_skills[@]}"
  154. }
  155. # Display what will be removed
  156. display_removal_plan() {
  157. local package_installed=$1
  158. shift
  159. local skills=("$@")
  160. echo ""
  161. echo "╔════════════════════════════════════════════════════════════════╗"
  162. echo "║ Uninstallation Plan ║"
  163. echo "╚════════════════════════════════════════════════════════════════╝"
  164. echo ""
  165. if [[ "$package_installed" == "true" ]]; then
  166. print_warning "Will remove npm package: ${PACKAGE_NAME}"
  167. else
  168. print_info "Package ${PACKAGE_NAME} not installed globally"
  169. fi
  170. echo ""
  171. if [[ ${#skills[@]} -gt 0 ]]; then
  172. print_warning "Will remove ${#skills[@]} installed skill(s):"
  173. echo ""
  174. # Group by platform
  175. declare -A platforms
  176. for skill_info in "${skills[@]}"; do
  177. IFS=':' read -r platform skill_name skill_path <<< "$skill_info"
  178. platforms[$platform]+=" • $skill_name\n"
  179. done
  180. for platform in "${!platforms[@]}"; do
  181. echo -e "${BOLD}${platform}:${NC}"
  182. echo -e "${platforms[$platform]}"
  183. done
  184. else
  185. print_info "No skills found in platform directories"
  186. fi
  187. if [[ "$PURGE" == "true" ]]; then
  188. echo ""
  189. print_warning "Will remove empty platform directories (--purge)"
  190. fi
  191. }
  192. # Confirm removal
  193. confirm_removal() {
  194. if [[ "$SKIP_CONFIRMATION" == "true" ]]; then
  195. return 0
  196. fi
  197. echo ""
  198. read -p "Do you want to proceed with uninstallation? [y/N] " -n 1 -r
  199. echo
  200. if [[ $REPLY =~ ^[Yy]$ ]]; then
  201. return 0
  202. else
  203. print_info "Uninstallation cancelled"
  204. exit 0
  205. fi
  206. }
  207. # Remove npm package
  208. remove_npm_package() {
  209. print_step "Removing npm package"
  210. if [[ "$DRY_RUN" == "true" ]]; then
  211. print_dry_run "Would run: npm uninstall -g ${PACKAGE_NAME}"
  212. return 0
  213. fi
  214. if npm uninstall -g "${PACKAGE_NAME}" > /dev/null 2>&1; then
  215. print_success "Package removed successfully"
  216. return 0
  217. else
  218. print_error "Failed to remove package"
  219. return 1
  220. fi
  221. }
  222. # Remove installed skills
  223. remove_skills() {
  224. local skills=("$@")
  225. if [[ ${#skills[@]} -eq 0 ]]; then
  226. return 0
  227. fi
  228. print_step "Removing installed skills"
  229. local removed_count=0
  230. local failed_count=0
  231. for skill_info in "${skills[@]}"; do
  232. IFS=':' read -r platform skill_name skill_path <<< "$skill_info"
  233. if [[ "$DRY_RUN" == "true" ]]; then
  234. print_dry_run "Would remove: $skill_path"
  235. continue
  236. fi
  237. if [[ -L "$skill_path" ]]; then
  238. # It's a symlink
  239. if rm "$skill_path" 2>/dev/null; then
  240. ((removed_count++))
  241. else
  242. print_error "Failed to remove symlink: $skill_path"
  243. ((failed_count++))
  244. fi
  245. elif [[ -d "$skill_path" ]]; then
  246. # It's a directory
  247. if rm -rf "$skill_path" 2>/dev/null; then
  248. ((removed_count++))
  249. else
  250. print_error "Failed to remove directory: $skill_path"
  251. ((failed_count++))
  252. fi
  253. fi
  254. done
  255. if [[ "$DRY_RUN" == "false" ]]; then
  256. if [[ $removed_count -gt 0 ]]; then
  257. print_success "Removed $removed_count skill(s)"
  258. fi
  259. if [[ $failed_count -gt 0 ]]; then
  260. print_warning "$failed_count skill(s) failed to remove"
  261. fi
  262. fi
  263. }
  264. # Cleanup empty platform directories
  265. cleanup_empty_dirs() {
  266. if [[ "$PURGE" == "false" ]]; then
  267. return 0
  268. fi
  269. print_step "Cleaning up empty directories"
  270. local platform_dirs=(
  271. "$HOME/.github/skills"
  272. "$HOME/.claude/skills"
  273. "$HOME/.codex/skills"
  274. "$HOME/.agent/skills"
  275. "$HOME/.gemini/skills"
  276. "$HOME/.gemini/antigravity/skills"
  277. "$HOME/.cursor/skills"
  278. "$HOME/.adal/skills"
  279. )
  280. for dir in "${platform_dirs[@]}"; do
  281. if [[ -d "$dir" ]] && [[ -z "$(ls -A "$dir" 2>/dev/null)" ]]; then
  282. if [[ "$DRY_RUN" == "true" ]]; then
  283. print_dry_run "Would remove empty directory: $dir"
  284. else
  285. if rmdir "$dir" 2>/dev/null; then
  286. print_success "Removed empty directory: $dir"
  287. fi
  288. fi
  289. fi
  290. done
  291. }
  292. # Show completion message
  293. show_completion() {
  294. echo ""
  295. if [[ "$DRY_RUN" == "true" ]]; then
  296. echo "╔════════════════════════════════════════════════════════════════╗"
  297. echo "║ ${BLUE}Dry Run Complete${NC} ║"
  298. echo "╚════════════════════════════════════════════════════════════════╝"
  299. echo ""
  300. print_info "No changes were made"
  301. print_info "Run without --dry-run to actually uninstall"
  302. else
  303. echo "╔════════════════════════════════════════════════════════════════╗"
  304. echo "║ ${GREEN}✓${NC} ${BOLD}Uninstallation Complete${NC} ║"
  305. echo "╚════════════════════════════════════════════════════════════════╝"
  306. echo ""
  307. print_success "CLI AI Skills has been uninstalled"
  308. echo ""
  309. print_info "To reinstall, run:"
  310. echo " ${CYAN}npx claude-superskills${NC}"
  311. echo " or"
  312. echo " ${CYAN}curl -fsSL https://raw.githubusercontent.com/ericgandrade/claude-superskills/main/scripts/install.sh | bash${NC}"
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 367 on GitHub
  313. fi
  314. echo ""
  315. }
  316. # Main uninstallation flow
  317. main() {
  318. parse_args "$@"
  319. # Show banner
  320. echo ""
  321. echo "╔════════════════════════════════════════════════════════════════╗"
  322. echo "║ ${BOLD}CLI AI Skills Uninstaller${NC} ║"
  323. echo "╚════════════════════════════════════════════════════════════════╝"
  324. echo ""
  325. if [[ "$DRY_RUN" == "true" ]]; then
  326. print_warning "DRY RUN MODE - No changes will be made"
  327. fi
  328. # Check if package is installed
  329. print_step "Checking installation"
  330. local package_installed="false"
  331. if check_package_installed; then
  332. package_installed="true"
  333. local installed_version=$(npm list -g "${PACKAGE_NAME}" 2>/dev/null | grep "${PACKAGE_NAME}" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "unknown")
  334. print_info "Found: ${PACKAGE_NAME}@${installed_version}"
  335. else
  336. print_info "Package not installed globally"
  337. fi
  338. # Find installed skills
  339. print_step "Scanning for installed skills"
  340. local skills_array=()
  341. while IFS= read -r line; do
  342. if [[ -n "$line" ]]; then
  343. skills_array+=("$line")
  344. fi
  345. done < <(find_installed_skills)
  346. if [[ ${#skills_array[@]} -gt 0 ]]; then
  347. print_info "Found ${#skills_array[@]} installed skill(s)"
  348. else
  349. print_info "No skills found"
  350. fi
  351. # Check if there's anything to remove
  352. if [[ "$package_installed" == "false" ]] && [[ ${#skills_array[@]} -eq 0 ]]; then
  353. echo ""
  354. print_info "Nothing to uninstall"
  355. exit 0
  356. fi
  357. # Display removal plan
  358. display_removal_plan "$package_installed" "${skills_array[@]}"
  359. # Confirm removal
  360. if [[ "$DRY_RUN" == "false" ]]; then
  361. confirm_removal
  362. fi
  363. # Remove npm package
  364. if [[ "$package_installed" == "true" ]]; then
  365. remove_npm_package
  366. fi
  367. # Remove skills
  368. remove_skills "${skills_array[@]}"
  369. # Cleanup empty directories
  370. cleanup_empty_dirs
  371. # Show completion
  372. show_completion
  373. }
  374. # Run main if executed directly (not sourced)
  375. if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
  376. main "$@"
  377. fi

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.