openshell-policy-advisor

Proposes narrow network policy changes when OpenShell sandbox requests are denied.

8.5k|1.3k|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/NVIDIA/OpenShell --skill openshell-policy-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openshell-policy-advisor
Source: https://github.com/NVIDIA/OpenShell/tree/main/crates/openshell-supervisor-process/src/skills/policy-advisor
Command: npx skills add https://github.com/NVIDIA/OpenShell --skill openshell-policy-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When an OpenShell sandbox blocks a network request with a policy_denied error, work stalls unless someone manually inspects the policy and crafts an exception. This Skill automates the recovery flow so legitimate tasks can proceed with minimal, approved policy changes.

Core Features & Use Cases

  • Denial Recovery: Detects policy_denied failures and treats them as recoverable rather than final when the user task still requires the request.
  • Policy Inspection: Reads the current sandbox policy from the policy.local endpoint and the policy advisor reference before proposing changes.
  • Narrow Proposals: Submits the narrowest possible policy proposal to the policy service, waits for approval, and retries only after policy_reloaded confirmation.
  • Use Case: An agent inside a sandbox needs to call an external API but receives policy_denied; the Skill inspects the active policy, proposes access to just that host, waits for approval, and retries the request.

Quick Start

When a sandbox request fails with policy_denied, ask the agent to inspect the current policy and submit a minimal proposal so the blocked request can be retried.

Frequently Asked Questions about openshell-policy-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a policy_denied error in an OpenShell sandbox?

A policy_denied error means the sandbox network policy blocked the request. Inspect the current policy at the policy.local endpoint, submit a narrow proposal for the needed access, wait for approval, and retry once the policy reloads.

How do I propose a network policy change in OpenShell?

Submit the narrowest possible proposal to the policy.local proposals endpoint covering only the required destination. Then poll the proposal wait endpoint until it is approved and the policy reports reloaded.

Should a denied sandbox request be retried immediately?

No. The request should only be retried after the policy proposal is approved and the policy service confirms a reload. Retrying before approval will simply produce another policy_denied response.

What is the policy.local endpoint in OpenShell?

policy.local is the in-sandbox policy service that exposes the current network policy and accepts change proposals. Agents query it to understand denials and request minimal policy adjustments.

When should a policy denial be treated as final?

A denial is final when the user task no longer needs the blocked request. If the task still requires it, the denial should trigger the proposal workflow instead of being reported as an unrecoverable failure.