claude-superskills

How to use claude-superskills

npx claude-superskills

{
  "name": "skill-creator",
  "version": "1.0.0",
  "description": "This skill should be used when the user wants to create a new skill",
  "category": "development",
  "triggers": ["create a skill", "new skill", "build a skill"],
  "tags": ["automation", "scaffolding"]
}
```

**Graceful Handling:**

- If skills directory doesn't exist: Return empty skill array
- If SKILL.md has no YAML frontmatter: Skip skill, continue
- If required fields missing (name, description): Log warning, skip
- If triggers is empty: Include skill with empty triggers array

### Step 3: Scan for MCP Servers

**Objective:** Discover configured MCP servers and their available tools.

**Actions:**

**3.1 Read MCP Configuration:**

```bash
# Check if MCP config exists
Read: {config.mcpConfig}
```

If file exists, parse JSON:

```json
{
  "mcpServers": {
    "claude_ai_Notion": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-notion"]
    },
    "plugin_playwright": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/playwright-mcp/index.js"]
    }
  }
}

What is claude-superskills?

claude-superskills is a JavaScript AI agent skill for Claude Desktop, Cursor, Codex with npx, git clone. 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. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.

Key capabilities

• Reusable instructions support
• Includes SKILL.md support
• Shell commands support
• Browser use support
• Presentation work support
• Document generation support
• OpenAI provider support

Available tools

Technical details

Install or run claude-superskills using npx. Check ericgandrade/claude-superskills for the latest setup command.

• Built for JavaScript
• Built for Node.js
• Built for Python
• Install or run with npx
• Install or run with git clone
• Works with Claude Desktop
• Works with Cursor
• Works with Codex

Requirements and access

Security and permissions

Review permissions before connecting any MCP server to an agent. Pay special attention to whether it can read local files, write data, call external services, or perform destructive actions.

When to use claude-superskills

• Use it for reusing agent instructions, scripts, and references.
• Use it for agent skills workflows.
• Use it for coding workflows.
• Use it for data workflows.
• Use it for claude desktop users.

Built with

Explore related resources

Frequently asked questions