policy-and-managed-settings

Route enterprise Copilot and VS Code controls to the correct policy implementation channel.

Updated Aug 30, 2026
One-click install
npx skills add https://github.com/Tyrizx/Tyrizx --skill policy-and-managed-settings-tyrizx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: policy-and-managed-settings
Source: https://github.com/Tyrizx/Tyrizx/tree/main/.github/skills/policy-and-managed-settings
Command: npx skills add https://github.com/Tyrizx/Tyrizx --skill policy-and-managed-settings-tyrizx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When adding or modifying any Copilot, agent, LLM, tool, permission, sandbox, MCP, telemetry, or configuration control in VS Code, contributors must decide where the enterprise policy belongs—runtime managed settings, a VS Code configuration policy, an extension policy, or a split implementation. Choosing the wrong channel leads to duplicated enforcement, silently ignored settings, or deprecated policy paths. ## Core Features & Use Cases - Decision routing: A flowchart routes each control to the correct destination based on where the governed behavior is implemented, with dedicated guides for SDK/runtime managed settings, VS Code configuration policy, extension policy, split runtime/editor control, and pre-1.133 permission-policy migration. - Managed settings reference: Documents the canonical flattened dot-path bag, the three delivery channels (native MDM, server-managed, file-based) with per-key precedence, structured JSON-string encoding, and the projection checklist for declaring managed-settings keys on policies. - Export and testing workflow: Prescribes running npm run export-policy-data for every policy change and using the mock policy server for local testing of managed-settings responses. - Use Case: A contributor adding a new Copilot agent permission control uses this Skill to determine it belongs in the runtime managed-settings schema, then follows the projection checklist to declare the key, attach it to a policy, and export the policy catalog. ## Quick Start Ask the assistant to use the policy-and-managed-settings skill to decide where a new Copilot enterprise control should be implemented and walk through the required declaration and export steps.

Frequently Asked Questions about policy-and-managed-settings

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

FAQPage Schema
How do I add an enterprise policy for a Copilot feature in VS Code?▼

Decide where the governed behavior is implemented: runtime-owned behavior goes into the managed-settings/SDK contract, editor or workbench behavior gets a VS Code configuration policy with a policy field, and extension settings use extensionConfigurationPolicy in vscode-distro. Then run npm run export-policy-data to regenerate the policy catalog.

What is the difference between managed settings and VS Code configuration policy?▼

Managed settings are runtime-owned enterprise controls delivered through native MDM, the GitHub server, or a file, flattened into a canonical dot-path bag. VS Code configuration policy governs editor and workbench behavior only and is declared on configuration registrations with a policy field.

How do managed settings precedence rules work across delivery channels?▼

Precedence is resolved per key: native MDM wins over the server-managed channel, which wins over the file-based channel. A key unset in a higher channel is still filled by a lower one, so an MDM-locked value cannot be overridden by server or file delivery.

Why is my managed setting silently ignored in VS Code?▼

The projection drops any key whose runtime value does not match the declared type. Structured object or array settings must be declared as type string because they travel as JSON strings; declaring number or boolean compiles but fails the runtime typeof check.

Can I add a new policy through the GitHub token account policy channel?▼

No. GitHub token and account policy data fields are deprecated for new controls and remain only for compatibility. New Copilot enterprise controls must use managed settings with runtime/SDK enforcement.

How do I test Copilot managed settings locally?▼

Use the mock policy server started with npm run mock-policy-server to serve managed_settings responses, then apply them via Developer: Sync Account Policy. It supports presets, a JSON control API, file-based deployment, and failure behaviors for testing forceRemoteSettingsRefresh.