How do I use SuperSkill?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SuperSkill score and load the best skill for testing my Go API" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

SuperSkill

by permanu

Overview Schema Related Servers Score Discussions

TypeScript

Local

SuperSkill

The runtime intelligence layer for AI agent skills.

npm license skills tools

The Problem

skills.sh solved skill discovery and installation — 90,000+ skills, 40+ agents, one standard. But installation is static. You browse, pick, install, and hope you chose right.

When you have 15 skills installed and say "write tests for my Go API" — which one loads? What about the three competing TDD skills? What if the model's context window can't fit them all?

skills.sh is where you find skills. SuperSkill is what loads the right one at the right time.

Related MCP server: ContextOS MCP Server

How It Works

Install skills however you want — npx skills add, manual download, or use the 87 built-in skills
Describe your task — "write tests for my Go API"
SuperSkill scores, resolves, and loads — trigger-based matching picks the best skill, resolves collisions, respects your context budget

SuperSkill scans your installed skills (from ~/.claude/skills/, ~/.cursor/skills/, etc.), merges them with its built-in catalog, and routes tasks to the best match at runtime.

What SuperSkill Adds

Layer	What it does	Why you need it
Router	Task description → best matching skill	No manual browsing or memorizing skill names
Arbiter	3 TDD skills installed? Profile picks the winner	Prevents collision chaos and token waste
Scanner	Discovers installed skills from any source	Works with skills.sh, manual installs, or built-in
Memory	Remembers activations within a session	No redundant fetches for similar tasks
Vault	ADRs, learnings, sessions, project context	Persistent knowledge that survives across sessions

Quick Start

Claude Code Plugin (recommended)

/plugin marketplace add permanu/superskill
/plugin install superskill

Any MCP-compatible tool

npm install -g superskill

Then add as an MCP server:

# Claude Code
claude mcp add superskill -e VAULT_PATH=~/Vaults/ai -- npx -y superskill

# Cursor, Claude Desktop, Codex, Gemini CLI — add to MCP config:

{
  "mcpServers": {
    "superskill": {
      "command": "npx",
      "args": ["-y", "superskill"],
      "env": { "VAULT_PATH": "~/Vaults/ai" }
    }
  }
}

Works with skills.sh

Install skills from the ecosystem, SuperSkill routes to them automatically:

npx skills add anthropics/skills          # Anthropic's official skills
npx skills add affaan-m/everything-claude-code  # ECC skill suite
# SuperSkill discovers and scores these on next activation

Supported AI Tools

Tool	Setup	Status
Claude Code	Plugin or MCP	Verified
Claude Desktop	MCP config	Verified
Cursor	MCP config	Verified
Codex CLI	MCP config	Verified
Gemini CLI	MCP config	Verified
OpenCode	MCP config	Community
Crush CLI	MCP config	Community
Droid	MCP config	Community
Windsurf	MCP config	Community
Aider	MCP config	Community
Continue	MCP config	Community

Built-in Skill Catalog

Core Workflow — loaded for every project:

Domain	Skills	Description
TDD	8	Red-green-refactor, Go/Python/Django/Spring/C++ testing, E2E
Planning	3	Implementation planning, CEO/eng review, execution
Code Review	4	PR review, Go review, Python review, feedback workflow
Debugging	2	Systematic debugging, investigation
Verification	4	Build/lint/type gates, Django/Spring verification
Brainstorming	2	Structured ideation, office hours
Agent Orchestration	5	Autonomous loops, RFC pipelines, subagents, parallel dispatch
Security	5	OWASP review, AgentShield scanning, Django/Spring security
Shipping	2	CI/CD, deployment patterns
Frontend Design	5	Anthropic official, Design Taste, Bencium UX, FDP, UI/UX Pro Max
Git Workflow	2	Worktrees, branch management

Language & Framework — loaded when your stack matches:

Domain	Skills	Description
Go	2	Idiomatic patterns, conventions
Python	2	Pythonic idioms, PEP 8
Django	3	Architecture, DRF, ORM, security, TDD
Spring Boot	4	Architecture, security, TDD, verification
Swift	4	SwiftUI, concurrency, actors, protocol DI
C++	2	Core Guidelines, GoogleTest
Java	2	Standards, JPA/Hibernate
Database	3	PostgreSQL, migrations, ClickHouse
Docker	1	Compose, container security

Infrastructure & Patterns:

Domain	Skills	Description
API Design	1	REST patterns, pagination, versioning
Frontend Patterns	1	React/Next.js state and performance
Backend Patterns	1	Node/Express server patterns
Coding Standards	1	Universal TS/JS/React standards

Specialized:

Domain	Skills	Description
Content & Business	6	Articles, investor materials, outreach, market research
3D Animation	5	Three.js, GSAP, React Three Fiber, Framer Motion, Babylon.js
Agent Engineering	4	Agent harness, eval, cost optimization
Meta/Tooling	5	Skill management, compaction, learning, browsing

MCP Tools

Tool	Description
`superskill`	Route to the best skill by task description, domain, or skill ID
`vault_skill`	Skill catalog, collisions, resolution, generation
`vault_project_context`	Auto-detected project context from CWD
`vault_init`	Generate draft context.md from a git repo
`vault_task`	Task management (add/list/update/board)
`vault_decide`	Log architecture decisions
`vault_learn`	Capture and list learnings
`vault_resume`	Resume context — recent sessions, interrupted work, next steps
`vault_session`	Multi-agent session coordination
`vault_read`	Read file or directory from vault
`vault_write`	Write/append/prepend content
`vault_search`	Full-text search across vault
`vault_prune`	Archive stale content
`vault_stats`	Vault content statistics
`vault_deprecate`	Mark items as deprecated

Configuration

Variable	Default	Description
`VAULT_PATH`	`~/Vaults/ai`	Path to knowledge vault
`MAX_INJECT_TOKENS`	`1500`	Max tokens for context injection
`SESSION_TTL_HOURS`	`2`	Session heartbeat TTL

Roadmap

See GitHub Milestones for planned work.

Contributing

See CONTRIBUTING.md.

License

AGPL-3.0-or-later — See LICENSE

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

2dResponse time

4dRelease cycle

12Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

mcp-skills
RAG Systems Developer Tools Code Execution
bobmatnyc
A
license
-
quality
F
maintenance
Provides dynamic, context-aware code assistant skills through hybrid RAG (vector + knowledge graph), enabling runtime skill discovery, automatic toolchain-based recommendations, and on-demand loading from multiple git repositories.
Last updated 2026-03-11
20
MIT
ContextOS MCP Server
RAG Systems Knowledge & Memory Agent Orchestration
itallstartedwithaidea
A
license
-
quality
C
maintenance
Unified context intelligence layer for AI agents, enabling orchestration of memory, reasoning, and self-healing indexes with cognition primitives and churn-aware retrieval routing.
Last updated 2026-08-05
27
MIT
skill-curator-mcp
Agent Orchestration Developer Tools
filhocf
A
license
-
quality
A
maintenance
Enables AI agents to intelligently match tasks to skills through semantic embeddings, track skill effectiveness, detect skill gaps, and discover new skills from external sources.
Last updated 2026-08-03
Apache 2.0
Skill Context Manager
Agent Orchestration Knowledge & Memory Autonomous Agents
Mavis2103
A
license
-
quality
A
maintenance
Provides context-aware skill selection for AI agents, reducing token usage by 85-98% and improving accuracy through semantic retrieval, session memory, and feedback learning.
Last updated 2026-06-30
MIT

View all related MCP servers

Related MCP Connectors

Execute Intent
Intent execution engine for autonomous agent task routing
AI Skill Store
Agent-first skill marketplace with USK open standard for Claude, Cursor, Gemini, Codex CLI.
Oakallow
Runtime permission, approval, and audit layer for AI agent tool execution.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/permanu/superskill'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

SuperSkill

The Problem

How It Works

What SuperSkill Adds

Quick Start

Claude Code Plugin (recommended)

Any MCP-compatible tool

Works with skills.sh

Supported AI Tools

Built-in Skill Catalog

MCP Tools

Configuration

Roadmap

Contributing

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

mcp-skills

ContextOS MCP Server

skill-curator-mcp

Skill Context Manager

Related MCP Connectors

Latest Blog Posts

MCP directory API