mirror of
https://github.com/harivansh-afk/sandbox-agent.git
synced 2026-04-15 05:02:11 +00:00
81 lines
1.8 KiB
Text
81 lines
1.8 KiB
Text
---
|
|
title: "Skills"
|
|
description: "Configure skill sources for agent sessions."
|
|
sidebarTitle: "Skills"
|
|
icon: "sparkles"
|
|
---
|
|
|
|
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.
|
|
|
|
```ts
|
|
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",
|
|
sessionInit: {
|
|
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.
|
|
|
|
| Type | `source` value | Example |
|
|
|------|---------------|---------|
|
|
| `github` | `owner/repo` | `"rivet-dev/skills"` |
|
|
| `local` | filesystem path | `"/workspace/my-skill"` |
|
|
| `git` | git 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](/custom-tools).
|