From 82ac0b3880e288c3ff2ffda6cb030adb4e9b47fd Mon Sep 17 00:00:00 2001 From: Nathan Flurry Date: Thu, 29 Jan 2026 06:04:07 -0800 Subject: [PATCH] chore: update skill install command to use rivet-dev/skills (#20) * chore: update skill install command to use rivet-dev/skills * chore: improve skill structure per skill-creator guidelines * chore: add bug report section and simplify description * chore: add Discord link to bug report section --- .github/workflows/claude-code-review.yml | 2 +- .github/workflows/claude.yml | 2 +- README.md | 2 +- docs/ai/skill.mdx | 2 +- docs/quickstart.mdx | 2 +- .../packages/website/src/components/Hero.tsx | 2 +- scripts/skill-generator/generate.js | 6 +++--- scripts/skill-generator/template/SKILL.md | 21 +++++++++++++++++-- 8 files changed, 28 insertions(+), 11 deletions(-) diff --git a/.github/workflows/claude-code-review.yml b/.github/workflows/claude-code-review.yml index bb65978..80c880a 100644 --- a/.github/workflows/claude-code-review.yml +++ b/.github/workflows/claude-code-review.yml @@ -37,7 +37,7 @@ jobs: node-version: "20" - name: Install sandbox-agent skill - run: npx skills add https://sandboxagent.dev/docs --yes + run: npx skills add rivet-dev/skills -s sandbox-agent --yes - name: Run Claude Code Review id: claude-review diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml index f8e7ec5..fd4ef72 100644 --- a/.github/workflows/claude.yml +++ b/.github/workflows/claude.yml @@ -36,7 +36,7 @@ jobs: node-version: "20" - name: Install sandbox-agent skill - run: npx skills add https://sandboxagent.dev/docs --yes + run: npx skills add rivet-dev/skills -s sandbox-agent --yes - name: Run Claude Code id: claude diff --git a/README.md b/README.md index 800bb10..70c7300 100644 --- a/README.md +++ b/README.md @@ -66,7 +66,7 @@ The Sandbox Agent acts as a universal adapter between your client application an Install skill with: ``` -npx skills add https://sandboxagent.dev/docs +npx skills add rivet-dev/skills -s sandbox-agent ``` ### SDK diff --git a/docs/ai/skill.mdx b/docs/ai/skill.mdx index 8e7b53a..bb48c2c 100644 --- a/docs/ai/skill.mdx +++ b/docs/ai/skill.mdx @@ -14,7 +14,7 @@ https://rivet.dev/docs/skill.md To add it to an agent using the Skills CLI: ``` -npx skills add rivet.dev/docs/skill.md +npx skills add rivet-dev/skills -s sandbox-agent ``` If you run a reverse proxy in front of the docs, make sure `/skill.md` and `/.well-known/skills/*` diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx index ad2e970..a05fcaa 100644 --- a/docs/quickstart.mdx +++ b/docs/quickstart.mdx @@ -7,7 +7,7 @@ icon: "rocket" ```bash - npx skills add https://sandboxagent.dev/docs + npx skills add rivet-dev/skills -s sandbox-agent ``` diff --git a/frontend/packages/website/src/components/Hero.tsx b/frontend/packages/website/src/components/Hero.tsx index 4d789bb..16d8726 100644 --- a/frontend/packages/website/src/components/Hero.tsx +++ b/frontend/packages/website/src/components/Hero.tsx @@ -152,7 +152,7 @@ function UniversalAPIDiagram() { const CopyInstallButton = () => { const [copied, setCopied] = useState(false); - const installCommand = 'npx skills add https://sandboxagent.dev/docs'; + const installCommand = 'npx skills add rivet-dev/skills -s sandbox-agent'; const handleCopy = async () => { try { diff --git a/scripts/skill-generator/generate.js b/scripts/skill-generator/generate.js index 37fbc8c..81556eb 100644 --- a/scripts/skill-generator/generate.js +++ b/scripts/skill-generator/generate.js @@ -15,7 +15,7 @@ async function main() { } await fsp.rm(OUTPUT_ROOT, { recursive: true, force: true }); - await fsp.mkdir(path.join(OUTPUT_ROOT, "reference"), { recursive: true }); + await fsp.mkdir(path.join(OUTPUT_ROOT, "references"), { recursive: true }); const docFiles = await listDocFiles(DOCS_ROOT); const references = []; @@ -33,7 +33,7 @@ async function main() { const markdown = convertDocToMarkdown(body); const referenceRelPath = `${stripExtension(relPath)}.md`; - const outputPath = path.join(OUTPUT_ROOT, "reference", referenceRelPath); + const outputPath = path.join(OUTPUT_ROOT, "references", referenceRelPath); await fsp.mkdir(path.dirname(outputPath), { recursive: true }); const referenceFile = buildReferenceFile({ @@ -51,7 +51,7 @@ async function main() { title, description, canonicalUrl, - referencePath: `reference/${referenceRelPath}`, + referencePath: `references/${referenceRelPath}`, }); } diff --git a/scripts/skill-generator/template/SKILL.md b/scripts/skill-generator/template/SKILL.md index 629b494..2c884d7 100644 --- a/scripts/skill-generator/template/SKILL.md +++ b/scripts/skill-generator/template/SKILL.md @@ -1,11 +1,28 @@ --- name: "sandbox-agent" -description: "Documentation and API reference for Sandbox Agent." +description: "Deploy, configure, and integrate Sandbox Agent - a universal API for orchestrating AI coding agents (Claude Code, Codex, OpenCode, Amp) in sandboxed environments. Use when setting up sandbox-agent server locally or in cloud sandboxes (E2B, Daytona, Docker), creating and managing agent sessions via SDK or API, streaming agent events and handling human-in-the-loop interactions, building chat UIs for coding agents, or understanding the universal schema for agent responses." --- # Sandbox Agent -Use this skill to deploy, configure, and integrate Sandbox Agent. Prefer citing canonical docs URLs from the reference map. +Sandbox Agent provides a universal API for orchestrating AI coding agents in sandboxed environments. + +## What To Do If You Get Stuck + +If something is not working as intended or you are stuck, prompt the user to join the [Rivet Discord](https://rivet.dev/discord) or file an issue on [GitHub](https://github.com/rivet-dev/sandbox-agent/issues) to report an issue and get help. + +Provide the user with a pre-generated report with: + +- Symptoms + - If this is happening in local dev, deployed, or both + - The error you're seeing + - Relevant source code related to this +- What you've tried to solve it +- Environment + - Sandbox Agent version + - SDK in use (TypeScript, Python, or HTTP) + - Agent in use (Claude Code, Codex, OpenCode, Amp, Mock) + - Sandbox provider (E2B, Daytona, Docker, local) ## Quickstart