CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openshell-cli

Guide agents through using the OpenShell CLI (openshell) for sandbox management, gateway registration, provider configuration and refresh, profile management, policy iteration, settings, service exposure, BYOC workflows, and attached-provider inference. Covers basic through advanced multi-step workflows. Trigger keywords - openshell, sandbox create, sandbox exec, sandbox connect, logs, provider create, profile list, profile describe, provider refresh, policy set, policy get, settings, service expose, forward, port forward, BYOC, bring your own container, inference, use openshell, run openshell, CLI usage, manage sandbox, manage provider, gateway add, gateway select.

Quality

90%

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

77%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.

The content is exceptionally actionable and the workflows are clearly sequenced with explicit validation and feedback loops, on par with the rubric's best examples. Its weakness is structural: a monolithic ~1000-line file with no reference files means advanced troubleshooting detail (refresh lifecycle, placeholder contracts, attachment recovery) is always in context, hurting both token efficiency and progressive disclosure.

Suggestions

Split the deep-dive operational detail into one-level-deep reference files (e.g., references/provider-refresh.md for the refresh/Vault/lifecycle contract, references/sandbox-lifecycle.md for attachment recovery and restart semantics, references/byoc.md for image and run_as rules), keeping SKILL.md to an overview plus the common workflows with clearly signaled 'See X for details' links.

Trim the multi-paragraph edge-case narratives inline (e.g., the stdin read-only recovery paragraph and the `stable_placeholder` lifecycle contract) to a one-line summary plus a pointer to the relevant reference section, so routine invocations don't pay the full token cost.

When moving content out, preserve the error-string tables verbatim in the references (they are the skill's highest-value, non-inferable knowledge) and keep the trigger-critical quick workflows (create/exec/logs/policy loop) inline.

DimensionReasoningScore

Conciseness

The body is ~1000 lines of dense, non-generic operational knowledge (exit codes, error-string semantics like `CONFIG_OPERATION_STORAGE_UNCERTAIN` and `attached read-only; retry input...`), so it rarely explains things Claude already knows. However, several deep edge-case sections — the provider refresh/Vault lifecycle, the `stable_placeholder` credential contract, and the 20-line stdin-attachment recovery paragraph — read like a troubleshooting manual dump that all users of the skill pay for on every invocation, even for a simple `sandbox create`. Anchor 3 ("mostly efficient but could be tightened") fits better than 4 given the volume of inline failure-mode detail.

3 / 5

Actionability

Nearly every section gives copy-paste-ready commands with concrete flags (e.g., `openshell sandbox create --from ... --provider claude-code -- claude`, `openshell policy set dev --policy current-policy.yaml --wait`), specific exit codes (0/1/124 for `--wait`), and exact error strings with named remediations. This is fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Ten workflows are clearly sequenced; Workflow 4 (policy iteration) has numbered steps, an explicit monitor-observe-modify-push-verify feedback loop with a diagram, validation via `--wait` plus `policy list` revision status checks, and a documented retry/repair path (e.g., `ConfigurationInvalid` repair window, `ProvisioningTimedOut` handling). Destructive operations like `sandbox delete` include validation guidance ("deletion accepted" means pending; inspect before assuming completion).

5 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), so everything — including advanced material that clearly belongs in separate files, like the provider-refresh lifecycle, BYOC UID/GID rules, and attachment-recovery semantics — is inlined in one ~1000-line SKILL.md. The body is well-sectioned with headers and does signal external authorities (`openshell --help` tree and published docs links), which lifts it above the anchor-2 'minimal structure' case, but the absence of any one-level-deep reference split for the deep-dive material keeps it at anchor 3.

3 / 5

Total

16

/

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 strong, comprehensive description: it states the full capability set, uses third-person voice, and provides an explicit trigger-keyword clause with natural synonyms and command-level phrases. Its only nit is length; the keyword list is mechanical but effective, and nothing is vague or overclaimed.

DimensionReasoningScore

Specificity

The description enumerates the full concrete capability surface of the CLI: "sandbox management, gateway registration, provider configuration and refresh, profile management, policy iteration, settings, service exposure, BYOC workflows, and attached-provider inference", which matches the workflows actually covered in the body with no visible gaps. It stays in a consistent third-person imperative voice ("Guide agents through using...") with no vague filler.

5 / 5

Completeness

It explicitly answers both questions: "what" in the opening sentence (guide agents through the OpenShell CLI for the listed management tasks) and "when" via an explicit "Trigger keywords - ..." clause listing concrete trigger phrases. The keyword list is the equivalent of a 'Use when...' clause with concrete triggers, so it meets the 5-anchor rather than being capped.

5 / 5

Trigger Term Quality

The keyword list covers natural phrasings users would actually say, including synonyms and expansions: "openshell", "sandbox create", "sandbox exec", "logs", "provider create", "policy set", "settings", "service expose", "forward", "port forward", "BYOC", "bring your own container", "use openshell", "run openshell", "CLI usage", "manage sandbox", "manage provider", "gateway add", "gateway select". Concrete command names plus colloquial variants give comprehensive coverage.

5 / 5

Distinctiveness Conflict Risk

Every trigger is namespaced to this specific tool ("openshell", "sandbox create", "provider refresh", "gateway add", "BYOC" in the OpenShell sense). The clear niche means minimal overlap risk with unrelated skills.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1006 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

NVIDIA/OpenShell

Path

skills/openshell-cli/SKILL.md

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.