Superpowers MCP Server
Used to clone and update the upstream Superpowers skills repository that provides expert-crafted workflows and processes for AI assistants.
Format used for SKILL.md files that define the content and structure of both Superpowers library skills and personal custom skills.
Runtime environment for the MCP server that exposes Superpowers skills library tools for finding and loading AI workflow skills.
Format used in skill file frontmatter to define metadata for custom skills including name and description fields.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Superpowers MCP Server list available skills for refactoring legacy code"
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.
Superpowers MCP Server for Augment
An MCP (Model Context Protocol) server that brings the powerful Superpowers skills library to Augment CLI. Access proven workflows, expert techniques, and best practices directly in your AI coding assistant.
What is This?
This MCP server exposes the Superpowers skills library as tools that Augment can use. Skills are expert-crafted workflows and processes that guide AI assistants to produce better results.
Available Tools:
find_skills- List all available skills from both the superpowers library and your personal skillsuse_skill- Load a specific skill to guide your work
Related MCP server: Agent Skills MCP
Prerequisites
Quick Start
1. Clone and Install
git clone https://github.com/jmcdice/superpower-mcp.git
cd superpower-mcp
./install.shThe installer will:
Clone the upstream Superpowers repository to
~/.augment/superpowersCreate a personal skills directory at
~/.augment/skillsInstall MCP server dependencies
Provide configuration instructions
2. Configure Augment
Add the MCP server to your Augment configuration file (~/.augment/settings.json):
{
"mcpServers": {
"superpowers": {
"command": "node",
"args": [
"/path/to/superpower-mcp/superpowers-mcp.js"
]
}
}
}Note: Replace /path/to/superpower-mcp/ with the actual path where you cloned this repository. The installer will show you the exact path to use.
3. Restart Augment
Restart Augment to load the new MCP server.
4. Test It
Ask Augment:
"What skills are available?"You should see a list of skills from the Superpowers library.
Usage
Finding Skills
Ask Augment to list available skills:
"Show me available skills"
"What skills can you use?"Or use the tool directly:
find_skills()Using Skills
Load a skill by name:
"Use the brainstorming skill"
"Load the test-driven-development skill"Or use the tool directly:
use_skill("superpowers:brainstorming")
use_skill("superpowers:test-driven-development")Skill Naming Convention
Superpowers skills:
superpowers:skill-name(from the upstream repository)Personal skills:
my-skill-name(from~/.augment/skills/)
Personal skills with the same name as superpowers skills will override them.
Creating Personal Skills
Create a directory in
~/.augment/skills/with your skill name:mkdir -p ~/.augment/skills/my-custom-skillAdd a
SKILL.mdfile with YAML frontmatter:--- name: my-custom-skill description: Use when you need to do something specific --- # My Custom Skill ## Purpose [Describe what this skill does] ## When to Use [Describe when to use this skill] ## Process 1. [Step 1] 2. [Step 2] 3. [Step 3]The skill will automatically be available through
find_skillsanduse_skill
Architecture
This is an overlay approach that works with the upstream Superpowers repository:
Upstream repository:
~/.augment/superpowers(read-only, updated via git pull)MCP server: This repository (custom Augment integration)
Personal skills:
~/.augment/skills(your custom skills)
The MCP server reads skills from both the upstream repository and your personal skills directory.
Management
Update Superpowers
To get the latest skills from the upstream repository:
./install.sh updateThen restart Augment.
Uninstall
./install.sh removeThis will:
Remove the Superpowers repository (
~/.augment/superpowers)Optionally remove your personal skills (
~/.augment/skills)Keep the MCP server files (you can delete them manually if desired)
Don't forget to remove the MCP server configuration from ~/.augment/settings.json and restart Augment.
Troubleshooting
MCP Server Not Showing Up
Check that the path in
~/.augment/settings.jsonis correctVerify Node.js is installed:
node --version(should be v18+)Check that dependencies are installed:
ls node_modulesin the repo directoryRestart Augment completely
Skills Not Loading
Verify the Superpowers repository exists:
ls ~/.augment/superpowers/skillsRun
./install.sh updateto refresh the repositoryCheck skill file format (must have YAML frontmatter and be named
SKILL.md)
Permission Errors
Make sure the install script is executable:
chmod +x install.shLinks
Superpowers Repository: https://github.com/obra/superpowers
Blog Post: Superpowers for Claude Code
Model Context Protocol: https://modelcontextprotocol.io/
Augment: https://www.augmentcode.com/
Contributing
Issues and pull requests are welcome! This is a community project to make Superpowers accessible to Augment users.
License
MIT License - See LICENSE file for details
The upstream Superpowers repository has its own license. Please refer to https://github.com/obra/superpowers for details.
Credits
Superpowers by Jesse Vincent
MCP Server integration for Augment
Available Tools
2 toolsfind_skillsB
List all available skills in the personal and superpowers skill libraries.
Inputs: no named parameters.
use_skillB
Load and read a specific skill to guide your work. Skills contain proven workflows, mandatory processes, and expert techniques.
Inputs: skill_name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: 'find_skills' is for listing available skills, while 'use_skill' is for loading and reading a specific skill. There is no overlap or ambiguity between them.
Both tools follow a consistent verb_noun pattern with snake_case naming: 'find_skills' and 'use_skill'. The naming is uniform and predictable throughout the set.
With only 2 tools, the server feels thin for a 'Superpowers MCP Server' that implies managing skills and workflows. This minimal set may not adequately cover the domain's potential scope, such as creating, updating, or deleting skills.
The tool set is severely incomplete for skill management. It only supports listing and reading skills, lacking essential CRUD operations like creating, updating, or deleting skills, which are likely needed for a comprehensive skill library system.
Related MCP Connectors
Search your team's shared AI-skill library, get install commands, and save skills from your agent.
Find, inspect and install reviewed reusable AI-agent capabilities from superskill.sh.
Search and load AI agent skills. Free metadata; full content requires a Pro or Studio account.
Agent skills for Claude, Codex and Cursor: find, install and load skills from one connector.
Related MCP Servers
- AlicenseAqualityCmaintenanceSearch, install, and manage AI agent skills (SKILL.md files) from GitHub repositories. Features workspace analysis for personalized recommendations and supports 140+ pre-indexed skills.938 npm12Creative Commons Attribution Non Commercial Share Alike 4.0 International
- AlicenseAqualityDmaintenanceEnables discovery and installation of agent skills from curated GitHub repositories, allowing users to search large collections and inspect skill contents directly. It supports downloading skills locally and provides grounded scaffolds for creating new skills based on existing patterns.52MIT
- AlicenseAqualityBmaintenanceEnables agents to discover, read, and use reusable skills stored in public GitHub repositories.417 npmMIT
- AlicenseAqualityCmaintenanceEnables LLM agents to discover and search a catalog of skills, then fetch skill instructions and supporting references, scripts, and assets on demand.10MIT