Skills on inference.sh follow the Agent Skills open standard. This means skills you create here work with Claude Code, Cursor, Windsurf, and any tool that supports the spec.
The Skill URL
Every skill has a stable content URL:
1https://api.inference.sh/skills/{namespace}/{name}/contentThis URL serves the skill's SKILL.md content (frontmatter + instructions). It can be used directly in any agent config that accepts a URL for context or instructions.
Supporting files are available at:
1https://api.inference.sh/skills/{namespace}/{name}/files/{path}For example: .../files/references/api-docs.md, .../files/scripts/helper.py
Claude Code
Claude Code discovers skills from the local filesystem. To use an inference.sh skill:
Manual Install
Download the skill files and place them in Claude Code's skills directory:
1~/.claude/skills/{skill-name}/2├── SKILL.md3├── references/4│ └── api-docs.md5└── scripts/6 └── helper.pyThe download endpoint provides a manifest of all files with their URLs:
1GET https://api.inference.sh/skills/{namespace}/{name}/downloadReturns:
1{2 "name": "code-review",3 "namespace": "inferencesh",4 "version": "1.0.0",5 "files": [6 { "path": "SKILL.md", "uri": "https://cdn.inference.sh/..." },7 { "path": "references/checklist.md", "uri": "https://cdn.inference.sh/..." }8 ]9}Download each file from its uri and write to the corresponding path under ~/.claude/skills/{name}/.
Belt CLI
1belt skill use inferencesh/code-reviewPrints the skill's main instructions (SKILL.md body) to stdout. Public skills do not require authentication.
When a skill has supplementary files (references/, scripts/, examples/), the CLI prints tips after the instructions:
1 tip: this skill has 3 supplementary file(s) not included above.2 install locally: belt skill add inferencesh/code-review3 list files: belt skill files inferencesh/code-reviewbelt skill add— downloads all files into your local skills directory (for Claude Code, Cursor, etc.)belt skill files— lists supporting file paths without downloading
Belt init (Codex, Cursor, Gemini CLI, Windsurf)
To install the full belt skill set and lifecycle hooks in one step:
1belt login2belt init cursor # or codex, gemini, windsurfThis installs five core skills (suggest, skill, apps, remember, belt) and writes hooks that call belt suggest on prompt submit and belt review on session stop. Skills are pulled from the platform when online; embedded fallbacks apply offline.
| Agent | Skills directory | Hooks config |
|---|---|---|
| codex | ~/.agents/skills/ | ~/.codex/hooks.json |
| cursor | ~/.cursor/skills/ | ~/.cursor/hooks.json |
| gemini | ~/.gemini/skills/ | ~/.gemini/settings.json |
| windsurf | ~/.windsurf/skills/ | ~/.codeium/windsurf/hooks.json |
Claude Code uses a separate flow: belt claude init (plugin marketplace). See Coding agents.
Cursor, Windsurf, Codex, and Gemini CLI
Use belt init to install belt skills and lifecycle hooks for supported local runtimes:
1belt init cursor2belt init windsurf3belt init codex4belt init geminiEach command installs five core belt skills (suggest, skill, apps, remember, belt) into the agent's skills directory and copies a hooks config. Skills are downloaded from the platform when you are logged in, with embedded fallbacks when offline. Hooks run belt suggest --json on prompt submit and belt review on stop.
| Agent | Skills directory | Hooks config |
|---|---|---|
| cursor | ~/.cursor/skills/ | ~/.cursor/hooks.json |
| windsurf | ~/.windsurf/skills/ | ~/.codeium/windsurf/hooks.json |
| codex | ~/.agents/skills/ | ~/.codex/hooks.json |
| gemini | ~/.gemini/skills/ | ~/.gemini/settings.json |
After belt init codex, run /hooks in Codex to review and trust belt hooks. Restart Cursor, Gemini CLI, or Windsurf after init.
For Claude Code, use belt claude init instead (plugin marketplace). See Coding agents.
Manual install
Any agent that supports the Agent Skills standard can use inference.sh skills without belt init:
- Get the skill files via the download endpoint or skill URL
- Place them where the agent expects to find skills
- The agent discovers and uses them like any other skill
Check your agent's documentation for where skills are stored and how they're discovered.
URL-Based Usage
Some agents support loading skills directly from a URL rather than the filesystem. In that case, point to the content URL:
1https://api.inference.sh/skills/{namespace}/{name}/contentThis returns the full SKILL.md content — frontmatter + instructions — ready for the agent to parse.
The Roundtrip Guarantee
Skills created on inference.sh produce the exact same SKILL.md format as the open standard. A skill created in the web editor and installed locally is indistinguishable from one written by hand:
- All spec frontmatter fields:
name,description,license,compatibility,metadata,allowed-tools - Same markdown body
- Same directory structure (
references/,scripts/,examples/,templates/)
This is by design — inference.sh is a creation and hosting platform, not a proprietary format.
Next
- Creating skills — build skills on inference.sh
- The registry — browse and share public skills
- Agent Skills standard — the open spec