Installing Skills

Install a skill to give your AI agent structured knowledge of the Oblien platform. Skills are plain folders with a SKILL.md - installing means placing them where your agent can find them.

Install via npx (recommended)

The oblien CLI auto-detects your agent and installs to the correct location:

# Detects agent from project structure
npx oblien skills install oblien-runtime

npx oblien skills install oblien-runtime --agent claude
# → .claude/skills/oblien-runtime/SKILL.md

npx oblien skills install oblien-runtime --agent cursor
# → .cursor/skills/oblien-runtime/SKILL.md

clawhub install oblien-runtime
# → ~/.openclaw/skills/oblien-runtime/SKILL.md

Install multiple skills or all at once:

npx oblien skills install oblien-runtime oblien-api oblien-networking
npx oblien skills install --all

Where skills go

Each agent has its own discovery path. The installer handles this automatically, but for manual installs:

Agent	Project-level	User-level
Claude Code	`.claude/skills/<name>/`	`~/.claude/skills/<name>/`
Cursor	`.cursor/skills/<name>/`	`~/.cursor/skills/<name>/`
OpenClaw	`<workspace>/skills/<name>/`	`~/.openclaw/skills/<name>/`
Goose	`.goose/skills/<name>/`	`~/.goose/skills/<name>/`
Custom	Any path the agent reads	-

Project-level skills override user-level skills with the same name.

Install into an Oblien workspace

Use the Runtime API to inject skills into a running workspace programmatically:

import Oblien from 'oblien';

const client = new Oblien({
  clientId: process.env.OBLIEN_CLIENT_ID!,
  clientSecret: process.env.OBLIEN_CLIENT_SECRET!,
});

const rt = await client.workspaces.runtime('ws_a1b2c3d4');

// Fetch and write the skill into the workspace
const res = await fetch('https://oblien.com/skills/oblien-runtime/SKILL.md');
const skillMd = await res.text();

await rt.files.write({
  fullPath: '/root/.claude/skills/oblien-runtime/SKILL.md',
  content: skillMd,
  createDirs: true,
});

SKILL=$(curl -s https://oblien.com/skills/oblien-runtime/SKILL.md)

curl -X POST https://workspace.oblien.com/files/write \
  -H "Authorization: Bearer $GATEWAY_JWT" \
  -H "Content-Type: application/json" \
  -d "{
    \"path\": \"/root/.claude/skills/oblien-runtime/SKILL.md\",
    \"content\": $(echo "$SKILL" | jq -Rs .),
    \"create_dirs\": true
  }"

When injecting skills into a workspace for an agent, use the agent's discovery path. For Claude Code inside a workspace, write to /root/.claude/skills/. For Cursor, /root/.cursor/skills/.

What to install

Use case	Skills	Why
Agent coding inside a workspace	`oblien-runtime`	Files, exec, search, terminal + workspace context
Agent managing workspaces	`oblien-api` + `oblien-networking`	Create/stop/scale workspaces + open ports, link workspaces
Agent doing both	`oblien-runtime` + `oblien-api` + `oblien-networking`	Full control - inside and outside the workspace
Agent new to the platform	`oblien-platform`	Architecture, auth, SDK, workflows - getting started guide

Start with oblien-runtime - it covers the most common agent workflow: operating inside a workspace (files, commands, search). It also includes platform context so the agent understands what a workspace is and how auth works. Add oblien-api when the agent needs to create or manage workspaces themselves.

Verify installation

# Claude Code
ls .claude/skills/
head -20 .claude/skills/oblien-runtime/SKILL.md

# Cursor
ls .cursor/skills/

# OpenClaw
ls ~/.openclaw/skills/

Update skills

Re-run the install command to get the latest version:

npx oblien skills install oblien-runtime

Skills update when the Oblien docs update.

Remove a skill

# Claude Code
rm -rf .claude/skills/oblien-runtime

# Cursor
rm -rf .cursor/skills/oblien-runtime

Next steps

Agent Setup - Per-agent configuration details for Claude Code, Cursor, OpenClaw, Goose
Skill Catalog - Browse all available skills
Skill Format - Understand the SKILL.md structure