CtrlK
BlogDocsLog inGet started
Tessl Logo

wiring-sbx-mcp-servers

Register Model Context Protocol servers on the host with sbx mcp and expose them to sandboxes through the built-in MCP gateway — registration, OAuth, static vs dynamic mode, and Cedar MCP policy. Use when adding an MCP server to a sandbox, deciding between --static-mcp and dynamic discovery, wiring OAuth credentials for a remote server, or writing a governance policy for MCP tool calls.

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

90%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally lean, high-signal skill body: concrete commands and executable policy examples, a clear registration→attachment→authorization→governance sequence, and honest trap documentation with time-sensitive details quarantined in a "Last verified" section. The only refinement space is splitting the Cedar policy and traps sections into a reference file and adding one or two explicit verification steps.

Suggestions

Add an explicit verification step after attachment and authorization (e.g., "Confirm with `sbx mcp inspect <name>` / `sbx mcp auth status <name>` before writing policy") to give the workflow a concrete checkpoint.

Move the Cedar policy section and the policy-related traps into a one-level-deep reference file (e.g., references/mcp-policy.md) and keep a short overview in SKILL.md, since policy authoring is only relevant to governed orgs.

Include one complete `sbx mcp add --command ... --args ...` example in the registration table so all three input shapes have a copy-paste-ready form.

DimensionReasoningScore

Conciseness

The body is dense with sbx-specific facts ("An npm-type package listed in that metadata is rejected, not translated", "Tokens live in the host OS credential store, never in the sandbox") and never explains what MCP, OAuth, or Cedar are — it assumes Claude's competence, so every token earns its place. Time-sensitive material (docs date, 0.38.0) is quarantined in the dedicated "Last verified" section, matching the rubric's exception, so it cannot be a 4 for padding.

5 / 5

Actionability

Guidance is fully executable: copy-paste console commands ("sbx mcp add slack --url https://slack.example.com/mcp --client-id <ID>", "sbx secret set mcp:slack.client_secret", "sbx mcp load <name> --sandbox <name>", "sbx mcp auth rm <server>"), a flag-to-execution table for all three input shapes of `sbx mcp add`, and complete runnable Cedar policy snippets with the @requireApproval annotation. The common cases are covered concretely; a 4 would require missing key details, and none are evident.

5 / 5

Workflow Clarity

The multi-step flow is clearly sequenced (register → choose static/dynamic at creation → authorize OAuth → attach with `sbx mcp load` → manage/policy), and the "Traps" section serves as an error-avoidance checkpoint for each stage. It is a 4 rather than 5 because there are no explicit validation checkpoints (e.g., verify attachment with `sbx mcp ls`/`inspect`, or confirm authorization via `mcp auth status`) before proceeding — verification is described as available but never prescribed as a step; a 3 would require the sequence itself to have gaps, which it does not.

4 / 5

Progressive Disclosure

The single file has no bundle files (no references/, scripts/, or assets/ exist), and its ~215 lines are broken into well-labeled sections (register, modes, OAuth, gateway tools, management, policy, traps) so navigation is easy. It is a 4 rather than 5 because the Cedar policy and traps material — roughly a third of the body and only relevant to governed orgs — would fit naturally in a one-level-deep reference file, keeping the overview leaner; it is not a 3 because what is present is clearly structured and not buried.

4 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A model description: concrete third-person capability statement, explicit and multi-scenario "Use when" triggers, comprehensive natural terminology, and a clearly bounded niche that avoids conflicts with sibling sbx skills. No changes needed.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Register Model Context Protocol servers on the host with sbx mcp and expose them to sandboxes through the built-in MCP gateway" plus the enumerated scopes "registration, OAuth, static vs dynamic mode, and Cedar MCP policy" — giving comprehensive, non-generic coverage of the skill's capabilities in third-person voice. It is not below 5 because no capability area is left to inference, and not below 4 because the enumerated scope list closes the 'minor gaps' a 4 allows.

5 / 5

Completeness

Both halves are explicit: the "what" is stated concretely (register on host, expose to sandboxes via the built-in gateway, covering registration/OAuth/modes/Cedar policy) and the "when" is an explicit multi-clause "Use when adding an MCP server to a sandbox, deciding between --static-mcp and dynamic discovery, wiring OAuth credentials..., or writing a governance policy for MCP tool calls". This matches the anchor where both what and when are answered with concrete trigger phrases; a 4 would mean the "when" was less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered: "adding an MCP server to a sandbox", "wiring OAuth credentials for a remote server", "writing a governance policy for MCP tool calls", plus exact CLI vocabulary like "--static-mcp" and "dynamic discovery", and both "MCP" and "Model Context Protocol" synonyms. It fits the comprehensive-with-synonyms anchor; a 4 would require noticeably missing natural terms, and none are evident for this domain.

5 / 5

Distinctiveness Conflict Risk

The niche is tightly defined (host-side `sbx mcp` registration and the sbx MCP gateway — not per-client MCP config, which the body explicitly distinguishes), with triggers naming sandbox-specific scenarios. Conflict risk with generic MCP or policy skills is minimal because every trigger is anchored to sbx/sandbox concepts.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
slurpyb/sbx-agent
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.