Inference Logoinference.sh

Using with Other Agents

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:

code
1https://api.inference.sh/skills/{namespace}/{name}/content

This 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:

code
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:

code
1~/.claude/skills/{skill-name}/2 SKILL.md3 references/4    api-docs.md5 scripts/6     helper.py

The download endpoint provides a manifest of all files with their URLs:

code
1GET https://api.inference.sh/skills/{namespace}/{name}/download

Returns:

json
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

bash
1belt skill use inferencesh/code-review

Prints 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:

text
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-review
  • belt 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:

bash
1belt login2belt init cursor     # or codex, gemini, windsurf

This 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.

AgentSkills directoryHooks 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:

bash
1belt init cursor2belt init windsurf3belt init codex4belt init gemini

Each 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.

AgentSkills directoryHooks 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:

  1. Get the skill files via the download endpoint or skill URL
  2. Place them where the agent expects to find skills
  3. 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:

code
1https://api.inference.sh/skills/{namespace}/{name}/content

This 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

we use cookies

we use cookies to ensure you get the best experience on our website. for more information on how we use cookies, please see our cookie policy.

by clicking "accept", you agree to our use of cookies.
learn more.