Setup Guide

Get supaskills running in Claude Code in under 3 minutes.

Create your API key

Your key starts with sk_supa_ and is shown only once. Copy it now.

Configure MCP in Claude Code (npm package)

Open Claude Code and run /mcp or edit your MCP settings directly:

~/.claude/mcp.json

{

"mcpServers": {

"supaskills": {

"type": "url",

"url": "https://supaskills.ai/api/mcp",

"headers": {

"Authorization": "Bearer sk_supa_YOUR_KEY"

}

Replace sk_supa_YOUR_KEY with your actual key. Restart Claude Code to pick up the new server.

•

Alternative: Remote MCP (no install)

Connect directly to the hosted server — no npm install needed. Uses Streamable HTTP transport at https://www.supaskills.ai/mcp

Claude Code CLI

terminal

$ claude mcp add supaskills-remote \

--transport http \

-H "Authorization: Bearer sk_supa_YOUR_KEY" \

-- https://www.supaskills.ai/mcp

Or edit ~/.claude/mcp.json directly

~/.claude/mcp.json

{

"mcpServers": {

"supaskills": {

"type": "streamable-http",

"url": "https://www.supaskills.ai/mcp",

"headers": {

"Authorization": "Bearer sk_supa_YOUR_KEY"

}

MCP Inspector

terminal

$ npx @modelcontextprotocol/inspector

URL: https://www.supaskills.ai/mcp

Transport: Streamable HTTP

Auth: Bearer sk_supa_YOUR_KEY

Available tools

Tool	Auth	Description
search_skills	Optional	Search by keyword, category, domain
get_skill	Required	Load full system prompt
list_categories	Optional	Browse 5 domains, 12 categories
suggest_skill	Optional	Describe task, get top 3 matches

Add CLAUDE.md to your project

Add this block to your project's CLAUDE.md so Claude Code automatically uses supaskills for domain-specific questions:

CLAUDE.md

## SupaSkills Integration

Before answering domain-specific questions,

search supaskills for a relevant expert skill:

- Use `search_skills` with natural language queries

- Use `load_skill` to get expert-level system prompts

- Use `suggest_skill` when unsure which skill fits

### Domains

Engineering, Technology, Business,

Content Creation, Legal

Full template: claude-md-template.md

Test it

Start a new Claude Code session in your project and try:

Search for a skill

Claude Code

You: "Help me optimize my React rendering performance"

Claude searches supaskills → finds "react-performance-optimization"

→ loads the skill → applies expert knowledge

Or use the REST API directly

terminal

$ curl -s https://supaskills.ai/api/v1/skills \

-H "Authorization: Bearer sk_supa_YOUR_KEY" \

| jq '.data[0].name'

"React Performance Optimization"

What's next

API Reference

Full endpoint docs, response formats, rate limits

Browse Skills

Explore 1,000+ expert skills across 5 domains

SupaScore

How we score skill quality across 6 dimensions

Pricing

Free, Pro, and Max plans

Questions? service@supaskills.ai