Integration docs

Three ways to use skills: install files natively, run our CLI, or connect the hosted MCP server once and load skills at runtime.

Getting started

  1. Create an account and grab an API key from Dashboard → API keys.
  2. Browse the marketplace and open any skill.
  3. Pick your ecosystem tab and either copy the file, run the CLI command, or connect via MCP.

MCP server — works with every ecosystem

The SkillingMain MCP server exposes search_skills, get_skill, and export_skill over Streamable HTTP. Endpoint: https://skillingmain.com/api/mcp with Authorization: Bearer sm_….

Claude Code

claude mcp add --transport http skillingmain https://skillingmain.com/api/mcp \
  --header "Authorization: Bearer sm_YOUR_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.skillingmain]
url = "https://skillingmain.com/api/mcp"
http_headers = { "Authorization" = "Bearer sm_YOUR_KEY" }

Cline / opencode / OpenClaw — JSON MCP config

{
  "mcpServers": {
    "skillingmain": {
      "type": "streamableHttp",
      "url": "https://skillingmain.com/api/mcp",
      "headers": { "Authorization": "Bearer sm_YOUR_KEY" }
    }
  }
}

Claude Code — Agent Skills

Skills export in the native Agent Skills format. Install to ~/.claude/skills/<slug>/SKILL.md (personal) or .claude/skills/<slug>/SKILL.md (project). Claude Code discovers them automatically and loads one when its description matches the task.

npx skillingmain install sql-optimizer --to claude

Codex — Agent Skills

Codex loads Agent Skills from the .agents/skills tree: ~/.agents/skills/<slug>/SKILL.md (personal) or .agents/skills/<slug>/SKILL.md (project). The older ~/.codex/prompts mechanism is deprecated. For always-on behavior, append the skill content to your repo's AGENTS.md.

npx skillingmain install sql-optimizer --to codex

Cline — rules

Skills install as Cline rules: .clinerules/<slug>.md in a project, or ~/Documents/Cline/Rules/<slug>.md globally. Toggle rules from the Rules popover under the chat input.

npx skillingmain install sql-optimizer --to cline --project

opencode — Agent Skills

opencode reads Agent Skills natively from ~/.config/opencode/skills/<slug>/SKILL.md (global) or .opencode/skills/<slug>/SKILL.md (project) — it also picks up .claude/skills and .agents/skills, so one install can serve multiple tools.

npx skillingmain install sql-optimizer --to opencode

OpenClaw — skills

OpenClaw uses the same Agent Skills format. Skills install to ~/.openclaw/skills/<slug>/SKILL.md, or into your workspace's skills/ directory, and load automatically.

npx skillingmain install sql-optimizer --to openclaw

Hermes — skills

Hermes (Nous Research) supports the Agent Skills format natively. Install to ~/.hermes/skills/<slug>/SKILL.md and Hermes loads it automatically. You can also connect the SkillingMain MCP server in ~/.hermes/config.yaml:

mcp_servers:
  skillingmain:
    url: https://skillingmain.com/api/mcp
    headers:
      Authorization: "Bearer sm_YOUR_KEY"
npx skillingmain install sql-optimizer --to hermes

CLI

# one-time setup
npx skillingmain login sm_YOUR_KEY

# find skills
npx skillingmain search "code review"

# install into one or more ecosystems (auto-detects what's on your machine)
npx skillingmain install code-review-checklist --to claude,cline
npx skillingmain install code-review-checklist --all

# project-scoped install (writes .claude/skills, .clinerules, .opencode)
npx skillingmain install code-review-checklist --to cline --project

The CLI ships in this repo under cli/ and has zero dependencies (Node 18+).

REST API

Authenticate with Authorization: Bearer sm_…. Base URL: https://skillingmain.com/api/v1.

GET  /api/v1/me                              # account, plan, usage
GET  /api/v1/skills?q=review&ecosystem=claude # search
GET  /api/v1/skills/{slug}                    # full skill content
GET  /api/v1/skills/{slug}/export/{target}    # files + install instructions
#    target: claude|codex|cline|opencode|openclaw|hermes|generic
curl -H "Authorization: Bearer sm_YOUR_KEY" \
  "https://skillingmain.com/api/v1/skills/code-review-checklist/export/claude"