--- name: universal-skills-manager description: "The master coordinator for AI skills. Discovers skills from multiple sources (SkillsMP.com, SkillHub, and ClawHub), manages installation, and synchronization across Claude Code, Gemini CLI, Google Anti-Gravity, OpenCode, and other AI tools. Handles User-level (Global) and Project-level (Local) scopes." compatibility: "Requires python3, curl, and network access to skillsmp.com, skills.palebluedot.live, clawhub.ai, and github.com" metadata: homepage: https://github.com/jacob-bd/universal-skills-manager disable-model-invocation: "true" requires-bins: "python3, curl" primaryEnv: SKILLSMP_API_KEY ---

Universal Skills Manager

This skill empowers the agent to act as a centralized skill manager for AI capabilities. It discovers skills from multiple sources — SkillsMP.com (curated, AI semantic search), SkillHub (community skills, no API key required), and ClawHub (versioned skills, semantic search, no API key required) — and unifies skill management across multiple AI tools (Claude Code, Gemini, Anti-Gravity, OpenCode, Cline, Cursor, etc.), ensuring consistency and synchronization.

When to Use This Skill

Activate this skill when the user:

• Wants to find or search for new skills.
• Wants to install a skill (from a search result or local file).
• Wants to sync skills between different AI tools (e.g., "Copy this Gemini skill to OpenCode").
• Asks to move or copy skills between scopes (User vs. Project).
• Mentions "Google Anti-Gravity", "OpenCode", or "Gemini" in the context of skills/extensions.
• Wants to package a skill for claude.ai, Claude Desktop, or ChatGPT (ZIP upload).

Supported Ecosystem

This skill manages the following tools and scopes. Always verify these paths exist before acting.

| Tool | User Scope (Global) | Project Scope (Local) | | :--- | :--- | :--- | | Gemini CLI | ~/.gemini/skills/ | ./.gemini/skills/ | | Google Anti-Gravity | ~/.gemini/antigravity/skills/ | ./.antigravity/extensions/ | | OpenCode | ~/.config/opencode/skills/ | ./.opencode/skills/ | | OpenClaw | ~/.openclaw/workspace/skills/ | ./.openclaw/skills/ | | Claude Code | ~/.claude/skills/ | ./.claude/skills/ | | OpenAI Codex | ~/.codex/skills/ | ./.codex/skills/ | | block/goose | ~/.config/goose/skills/ | ./.goose/agents/ | | Roo Code | ~/.roo/skills/ | ./.roo/skills/ | | Cursor | ~/.cursor/skills/ | ./.cursor/skills/ | | Cline | ~/.cline/skills/ | ./.cline/skills/ |

Cloud Platforms (ZIP Upload Required):

| Platform | Installation Method | | :--- | :--- | | claude.ai | Upload ZIP via Settings → Capabilities → Upload Skill | | Claude Desktop | Upload ZIP via Settings → Capabilities → Upload Skill | | ChatGPT | Upload ZIP via Profile → Skills → New skill → Upload from your computer |

Note: claude.ai, Claude Desktop, and ChatGPT don't have access to local environment variables. Use the "Package for Cloud Upload" capability (Section 5) to create a ZIP. Embedding an API key is optional — SkillHub and ClawHub search work without one. If you do include a key, do NOT share the ZIP publicly (see Section 5 for credential safety guidance).

ChatGPT Skills are currently in beta and available on Business, Enterprise, Edu, Teachers, and Healthcare plans. Skills are off by default for Enterprise/Edu — workspace admins must enable them in Permissions & roles.

IMPORTANT - Universal Skills Manager Platform Limitations:

This skill (Universal Skills Manager) requires network access to call the SkillsMP API, SkillHub API, ClawHub API, and GitHub. Handle these scenarios:

• If user asks to package/ZIP the Universal Skills Manager itself for claude.ai or ChatGPT:

Tell the user: "The Universal Skills Manager won't work on claude.ai or ChatGPT because it requires network access to call the SkillsMP API, SkillHub API, ClawHub API, and GitHub APIs. These platforms' code execution environments don't allow outbound network requests. However, I can package OTHER skills for cloud upload - those will work as long as they don't require network access."

• If user wants to try the Universal Skills Manager on Claude Desktop:

Tell the user: "Claude Desktop has network access capabilities, but there is a known bug where custom domains added to the 'Additional allowed domains' setting are not included in the network egress JWT token. This means the skill cannot reach the required APIs even after whitelisting them.

Required domains (for when the bug is fixed): - skillsmp.com (for SkillsMP skill searches) - skills.palebluedot.live (for SkillHub skill searches) - clawhub.ai (for ClawHub skill searches and direct file downloads) - api.github.com and raw.githubusercontent.com (for skill downloads from GitHub)

Workaround: Use Claude Code CLI instead, which has unrestricted network access and works with all three skill sources. You can install via: curl -fsSL https://raw.githubusercontent.com/jacob-bd/universal-skills-manager/main/install.sh | sh -s -- --tools claude"

(Note: If a tool uses a different directory structure, ask the user to confirm the path, then note it for future reference.)

Core Capabilities

1. Smart Installation & Synchronization

Trigger: User asks to install a skill (e.g., "Install the debugging skill" or "Install skill ID xyz").

Procedure:

1. Identify Source:

* If from SkillsMP search result: Use the githubUrl from the API response * If from SkillHub search result: Fetch skill details via /api/skills/{id} to get skillPath and branch, then construct GitHub tree URL * If from ClawHub search result: Use the slug to fetch content via ClawHub's /file endpoint (see Section C below) * If from skill name/ID: Search available sources (SkillsMP, SkillHub, and/or ClawHub) to find the skill * If local: Identify the source path

1. Verify Repository Structure (CRITICAL):

* Before downloading, browse the GitHub repo to confirm the skill folder location * Use GitHub API to list directory contents: GET /repos/{owner}/{repo}/contents?ref={branch} * Look for folders containing SKILL.md - this is the actual skill directory * Common patterns: skill/, skills/{name}/, root level, or custom folder names * Confirm the correct path before generating the download URL

1. Download Using Helper Script:

* Use install_skill.py (located in this skill's scripts/ folder): ```bash python3 ~/.claude/skills/universal-skills-manager/scripts/install_skill.py \ --url "https://github.com/{owner}/{repo}/tree/{branch}/{skill-folder}" \ --dest "{target-path}" \ --dry-run # Preview first, then remove flag to install ``` * The script handles: atomic install, validation, subdirectories, safety checks * Safety feature: Script will abort (exit code 4) if destination is a root skills directory * Update detection: If skill exists, shows diff and prompts for confirmation * Security scan: The install script automatically scans downloaded skills for security threats (invisible characters, data exfiltration, prompt injection). Review any findings before proceeding.

1. Determine Primary Target:

* Ask: "Should this be installed Globally (User) or Locally (Project)?" * Determine the primary tool (e.g., if user is in Claude Code, Claude is primary) * If the user specifies claude.ai, Claude Desktop, or ChatGPT as the target, go to Step 4a instead of Step 5.

...