Agent skill · microsoft

policy-and-managed-settings

Use whenever adding, modifying, or reviewing any Copilot, agent, LLM, AI, tool, permission, sandbox, MCP, model, telemetry, feature-gate, setting, configuration, or enterprise control—especially anything an organization or administrator may need to manage. Start here to decide whether it belongs in runtime managed settings, a typed SDK contract, VS Code configuration policy, extension policy, or a split implementation. Run on every new Copilot/agent/LLM control and ANY change that adds a `policy:` field.

What it needs

About 2k tokens when loaded.

What this skill does

Enterprise Policy and Managed Settings Route a control by where the governed behavior is implemented, not by who requested it. Most Copilot agent controls belong in the runtime, not VS Code. Governed behavior Destination Guide --- --- --- Copilot runtime: tools, shell, files, URLs, MCP, plugins, subagents, permissions, sandbox, runtime model/telemetry Runtime managed setting (SDK type only if the host owns the value) sdk-runtime-policy.md VS Code editor/workbench VS Code configuration policy: vscode-policy.md Extension-contributed setting extensionConfigurationPolicy in vscode-distro extension-policy.md Independent runtime and editor behavior Split: runtime setting for agent behavior, VS Code policy for editor behavior only both of the above Existing permission policy introduced before 1.133 Bounded migration only legacy-permission-policy.md Supporting references: github-managed-settings.md: projecting managed settings into VS Code policy (channels, precedence, key declaration). policy-support-maintenance.md: Agent Host support inventory and Policy Diagnostics readiness. local-testing.md: mock policy server. Rules Runtime enforcement is authoritative. Do not duplicate runtime parsing, matching, or security decisions in VS Code, and never substitute editor UI suppression for runtime enforcement. New Copilot controls go directly in the shared managed-settings schema/SDK contract. Do not add a VS Code setting to mirror or bridge one. Closed to new properties (existing entries stay for compatibility): GitHub token/account IPolicyData fields consumed by AccountPolicyService, the legacy VS Code setting bridge, and pre-1.133 permission translation. Split controls: add the runtime capability first and keep existing editor behavior until it ships. Keep both projections semantically aligned; keep permission authorization separate from sandbox containment; make create/resume/removal/peer/subagent/cloud behavior explicit. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills microsoft/policy-and-managed-settings

View the source on GitHub

Browse the @skills marketplace