troubleshoot-sandbox

troubleshoot-sandbox is a skill for Claude Code from opensandbox-group/OpenSandbox. It costs 48 tokens per session (1,149 once invoked), scanned A, original, Apache-2.0.

A troubleshooting workflow for diagnosing failed or unhealthy OpenSandbox environments using command-line tools or web requests. It checks sandbox status, logs, events, resource details, and diagnostic summaries.

In plain words
What is it for?
Investigating sandbox creation and runtime failures, checking whether a sandbox exists or is running, and collecting diagnostic information from the CLI or HTTP API.
Why use it?
It turns vague sandbox failures into evidence that can reveal problems such as running out of memory, crashes, image-download failures, or network issues.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter.

Good fit Investigating sandbox creation and runtime failures, checking whether a sandbox exists or is running, and collecting diagnostic information from the CLI or HTTP API.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/opensandbox-group/opensandbox/troubleshoot-sandbox
About the project

OpenSandbox is a sandbox platform that gives AI applications APIs, SDKs, and runtimes for creating isolated environments, running commands, and managing files. It is used for coding and GUI agents, browser automation, code execution, agent evaluation, and reinforcement-learning training across Docker and Kubernetes environments. The catalogue entries provide instructions and a skill for working with these sandboxes.

opensandbox-group/OpenSandbox · 15,070 stars · on GitHub · open-sandbox.ai

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add opensandbox-group/OpenSandbox --skill troubleshoot-sandbox
Clone the repo
git clone --depth 1 https://github.com/opensandbox-group/OpenSandbox

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for troubleshoot-sandbox

README.md
[![agentmods](https://agentmods.dev/badge/skills/opensandbox-group/opensandbox/troubleshoot-sandbox/github.svg)](https://agentmods.dev/skills/opensandbox-group/opensandbox/troubleshoot-sandbox)
Your own site
<a href="https://agentmods.dev/skills/opensandbox-group/opensandbox/troubleshoot-sandbox"><img src="https://agentmods.dev/badge/skills/opensandbox-group/opensandbox/troubleshoot-sandbox/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for troubleshoot-sandbox

Your own site · 80×15
<a href="https://agentmods.dev/skills/opensandbox-group/opensandbox/troubleshoot-sandbox"><img src="https://agentmods.dev/badge/skills/opensandbox-group/opensandbox/troubleshoot-sandbox.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,149 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00048 $0.01149
Opus 5 $0.00024 $0.00575
Sonnet 5 $0.00010 $0.00230
Haiku 4.5 $0.00005 $0.00115

Measured 10d ago against content hash 124583a54875, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

troubleshoot-sandbox scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

There are two ways to interact with the diagnostics API: **CLI** (if opensandbox CLI is installed) or **HTTP** (curl against the server directly). Use whichever is available. The HTTP approach works regardless of how the
skills/troubleshoot-sandbox/SKILL.md · 113 lines

How it starts

The opening of the file, as written. The whole thing — 113 lines — stays where its author put it; the contents beside it link to each section on GitHub.

OpenSandbox Troubleshooting

Troubleshoot sandbox $ARGUMENTS using the opensandbox diagnostics.

There are two ways to interact with the diagnostics API: CLI (if opensandbox CLI is installed) or HTTP (curl against the server directly). Use whichever is available. The HTTP approach works regardless of how the sandbox was created (SDK, API, CLI).

Workflow

Step 1: Confirm sandbox state

CLI:

opensandbox sandbox get <sandbox-id>

HTTP:

curl http://<server-domain>/v1/sandboxes/<sandbox-id>

If the server requires authentication, add -H "OPEN-SANDBOX-API-KEY: <your-key>" to all curl commands.

Check the sandbox status (Running, Pending, Paused, Failed, etc.). If the sandbox is not found, it may have been deleted or expired.

Step 2: Get diagnostics summary (recommended first action)

CLI:

opensandbox devops summary <sandbox-id>

HTTP:

curl http://<server-domain>/v1/sandboxes/<sandbox-id>/diagnostics/summary

This returns a combined plain-text view of:

  • Inspect: container/pod details (status, resources, network, labels)
  • Events: state transitions, OOM kills, errors
  • Logs: recent container output

Read the output carefully and look for common failure patterns listed below.

Step 3: Drill down if needed

If the summary is not enough, use individual endpoints for more detail:

CLI:

opensandbox devops logs <sandbox-id> --tail 500
opensandbox devops logs <sandbox-id> --since 30m
opensandbox devops inspect <sandbox-id>
opensandbox devops events <sandbox-id> --limit 100

HTTP:

# Get more log lines
curl "http://<server-domain>/v1/sandboxes/<sandbox-id>/diagnostics/logs?tail=500"

# Get logs from recent time window
curl "http://<server-domain>/v1/sandboxes/<sandbox-id>/diagnostics/logs?since=30m"

# Detailed container/pod inspection
curl "http://<server-domain>/v1/sandboxes/<sandbox-id>/diagnostics/inspect"

# More events
curl "http://<server-domain>/v1/sandboxes/<sandbox-id>/diagnostics/events?limit=100"

Read the full file on GitHub · 113 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 113 lines · 48 tokens per session scan A 124583a54875

Subscribe to this mod's changes

troubleshoot-sandbox is a skill published in the GitHub repository opensandbox-group/OpenSandbox (15,070 stars, last pushed yesterday), licensed Apache-2.0. It adds 48 tokens to every session and 1,149 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

network-rca

Kubernetes network root cause analysis skill powered by Kubeshark MCP. Use this skill whenever the user wants to investigate past incidents, perform retrospective traffic analysis, take or manage traffic snapshots, extract PCAPs, dissect L7 API calls from historical captures, compare traffic patterns over time, detect…

kubeshark/kubeshark · 163 tokens

k8s-service-path

Trace the Kubernetes service path — Service to selector to pods to EndpointSlices to readiness, plus Ingress routing. Use when a service is getting no traffic, an ingress is not routing, or someone asks why a workload is unreachable inside a cluster.

automateyournetwork/netclaw · 55 tokens

k8s-agent-sandbox-mcp

An MCP server skill for managing Kubernetes sandboxes. Enables creating, executing commands, managing files, and terminating instances via the official kubernetes-sigs/agent-sandbox MCP server.

kubernetes-sigs/agent-sandbox · 46 tokens

cluster-events

Analyze cluster-wide Kubernetes events to identify issues and patterns. Aggregates Warning events, detects high-frequency patterns, and correlates related events.

scitix/siclaw · 30 tokens

quota-debug

Diagnose Kubernetes native ResourceQuota and LimitRange admission rejections (exceeded quota, forbidden by LimitRange, FailedCreate). Checks namespace quotas, current usage, LimitRange constraints, and ReplicaSet events to identify why pods cannot be created. Not applicable to Volcano Queue — use…

scitix/siclaw · 69 tokens

volcano-diagnose-pod

Diagnose Volcano-managed Pod scheduling issues. Checks Pod status, PodGroup, events, and Queue to identify scheduling failures.

scitix/siclaw · 32 tokens