Super Agent Skill
Try it

Connect · MCP

One MCP server.
Every coding agent — Hermes first.

Hermes is our featured runtime — one curl and you're wired. Claude, Cursor, Codex, VS Code, Zed, n8n and every other MCP-compatible client just below. Read tools are anonymous; write tools take a token.

Streamable HTTP endpoint

https://superagentskill.com/api/public/mcp
Live·3 read tools · free·4 write tools · token
Recommended runtime · Featured

Hermes × Super Agent Skill

Hermes is our reference agent runtime. It picks up new skills every session, proxies OAuth for write tools, and the installer below is idempotent — safe to re-run any time. If you're deciding what to try first, start here.

  • One command · zero JSON · backs up your existing config.
  • Auto-refreshes the skill catalog on every session start.
  • OAuth-ready for upload_packages and other write tools.
View install script

Paste in your terminal

terminal — safe to re-run
curl -fsSL https://superagentskill.com/api/public/install.hermes.sh | bash

Prefers offline verification? Read the script first — it's a signed .sh served from /api/public/, no external redirects.

One click · zero JSON

Install in your editor with a single click

These buttons use the editor's own deep-link install scheme — the app opens with the Super Agent Skill MCP server already configured. Don't see your client? Use the copy-paste configs below or the CLI.

Install in CursorOpens Cursor and pre-fills the MCP server config.Install in VS CodeVS Code 1.93+ — adds the server to user settings.Install in VS Code InsidersSame as VS Code but targets the Insiders build.

Paste-a-bearer route: generate a token at /account/tokens and drop it into any client that supports a static Authorization: Bearer … header — useful for Hermes, OpenClaw, Grok, n8n, or any runtime where the OAuth dance is flaky.

01 · Fastest path

Don't touch JSON. Paste a prompt.

Pick your agent. Paste the prompt in chat. It writes the config, restarts, and runs a test call so you know it works.

Paste in One prompt → fully connected (recommended)
Connect me to the "Super Agent Skill" MCP server with full access (read + write tools).

Use the Streamable HTTP endpoint https://superagentskill.com/api/public/mcp.

1. Add it to my MCP client (Claude Code / Claude Desktop / Cursor / Codex / VS Code / Windsurf).
   - Claude Code: claude mcp add --transport http super-agent-skill https://superagentskill.com/api/public/mcp
   - Claude Desktop / Cursor / VS Code: write the JSON config for my OS (preserve existing servers).
2. For write tools (upload_packages, request_primitive, report_execution): the client opens OAuth in my browser on first call. If my client doesn't auto-OAuth, mint a token at https://superagentskill.com/account/tokens and add Authorization: Bearer <token> to the MCP config.
3. Restart the client, call the MCP tool "overview", and show me the intent→tool map.

If anything fails, paste the exact error and the config file you wrote.

For write tools (upload_packages, request_primitive), append Authorization: Bearer <token> from Account → Tokens.

02 · Verify

Test the MCP server, right here.

Probe the live endpoint from your browser or a shell. No setup needed.

Test MCP live

Same endpoint your client will hit

Calls POST /api/public/mcp with the proper Accept header. Read tools work anonymously; write tools need a token from /account/tokens.

Authorization (optional)

Sent as Authorization: Bearer …. Mint one at /account/tokens.

Or hit the public health endpoint from your terminal

Confirms reachability from your network and enumerates the live tool catalog — no auth.

shell
curl -s https://superagentskill.com/api/public/mcp | jq

03 · Configs

Manual setup for every client.

Pick your client. Copy the snippet. Restart. Tools appear in the agent.

Hermes

Reference runtime

★ Featured · one-liner

Hermes is our recommended agent runtime. One curl edits ~/.hermes/config.yaml idempotently (with backup) and wires Super Agent Skill in — every session picks up new skills automatically.

  1. 1Run the one-liner in any terminal.
  2. 2The installer backs up your config, appends the superagent-skill MCP block, and exits.
  3. 3Run `hermes mcp list` to confirm — tools appear immediately, no restart needed.
terminal — idempotent, backs up your config
curl -fsSL https://superagentskill.com/api/public/install.hermes.sh | bash

Note: Prefer to edit by hand? Add a `superagent-skill` entry to `mcp_servers` in ~/.hermes/config.yaml pointing at https://superagentskill.com/api/public/mcp (transport: http).

04 · Power moves

Once connected — what to ask the agent.

Three intent groups. Copy a prompt, swap a path or topic, send. The agent routes to @superagentskill automatically.

Significantly improve a local skill, playbook, soul or guardrail. Uses get_methodology → review_skill → host edits → re-score. The score delta is the proof.

Upgrade a skill end-to-end
Use @superagentskill to significantly upgrade my local skill at .claude/skills/code-reviewer.md.
1. Call get_methodology to load the rubric.
2. Call review_skill on the file's raw content — show me the per-pillar score.
3. Edit the file in place applying every top_action.
4. Re-run review_skill and show the before/after grade and per-pillar delta.
Stop only when the overall score is >= 90.
Audit & harden a playbook
Use @superagentskill to audit docs/playbooks/incident-response.md against the SuperAgentSkill methodology.
Score it, then rewrite the 3 weakest pillars in place.
Show the diff and the new overall_score. Don't touch pillars already at >= 80.
Harden a soul / persona
Use @superagentskill to upgrade the soul at agents/nova/SOUL.md.
Focus on Identity, Guardrails and Trust pillars.
After review_skill, also call search_registry type="soul" to borrow patterns from the 3 highest-trust souls. Merge what fits, then re-score.
Author a new guardrail
Use @superagentskill: call get_methodology, then draft a brand-new guardrail file at .agents/guardrails/no-pii-leak.md that scores >= 90 on every pillar. Verify by calling review_skill on your draft BEFORE handing it to me.
Batch-upgrade a folder
Use @superagentskill to upgrade every .md file under .claude/skills/.
For each file: review_skill → edit in place → re-review. Skip files already at grade A.
At the end, print a table: file | before | after | delta.
Compare two versions
Use @superagentskill to score both versions of my skill (skill-v1.md and skill-v2.md) with review_skill.
Tell me which one wins per pillar, what v2 broke that v1 had right, and what to merge into a v3.

Pro tips

  • → If the agent can't find the server, ask it to call overview first — it returns the full intent → tool map.
  • → Always run review_skill twice (before and after edits). The score delta is the proof.
  • → Always call get_skill_trust before recommending a registry primitive.
  • → If your client doesn't auto-mention MCP servers, just write: "Using the superagentskill MCP, …"

Don't see your client?

Any runtime that speaks MCP Streamable HTTP connects with the same URL. The full reference (tools, schemas, errors) lives in the MCP docs.