Skip to main content
Skills are local instruction bundles stored in SKILL.md files.

​
Configuring skills

Use setSkillsConfig / getSkillsConfig / deleteSkillsConfig to manage skill source config by directory + skill name. 
import { SandboxAgent } from "sandbox-agent";

const sdk = await SandboxAgent.connect({
  baseUrl: "http://127.0.0.1:2468",
});

// Add a skill
await sdk.setSkillsConfig(
  {
    directory: "/workspace",
    skillName: "default",
  },
  {
    sources: [
      { type: "github", source: "rivet-dev/skills", skills: ["sandbox-agent"] },
      { type: "local", source: "/workspace/my-custom-skill" },
    ],
  },
);

// Create a session using the configured skills
const session = await sdk.createSession({
  agent: "claude",
  cwd: "/workspace",
});

await session.prompt([
  { type: "text", text: "Use available skills to help with this task." },
]);

// List skills
const config = await sdk.getSkillsConfig({
  directory: "/workspace",
  skillName: "default",
});

console.log(config.sources.length);

// Delete skill
await sdk.deleteSkillsConfig({
  directory: "/workspace",
  skillName: "default",
});

​
Skill sources

Each skills.sources entry describes where to find skills.
Typesource valueExample
githubowner/repo"rivet-dev/skills"
localfilesystem path"/workspace/my-skill"
gitgit clone URL"https://git.example.com/skills.git"
Optional fields:
  • skills: subset of skill directory names to include
  • ref: branch/tag/commit (for github and git)
  • subpath: subdirectory within repo to scan

​
Custom skills

To write, upload, and configure your own skills inside the sandbox, see Custom Tools.