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
- Create an account and grab an API key from Dashboard → API keys.
- Browse the marketplace and open any skill.
- 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|genericcurl -H "Authorization: Bearer sm_YOUR_KEY" \ "https://skillingmain.com/api/v1/skills/code-review-checklist/export/claude"