add-policy

Add and validate VS Code configuration policies with TypeScript checks and artifact regeneration.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/aadorian/VSCode_Readme --skill add-policy-aadorian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-policy
Source: https://github.com/aadorian/VSCode_Readme/tree/main/education/engineering-tooling/github/copilot-skills/add-policy
Command: npx skills add https://github.com/aadorian/VSCode_Readme --skill add-policy-aadorian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you add, modify, and review VS Code configuration policies so enterprise-controlled settings behave correctly across supported platforms and account-based policy sources.

Core Features & Use Cases

  • Policy Registration: Define the correct policy metadata for a configuration setting, including category, version gating, and localization.
  • Policy Lifecycle Review: Evaluate changes that introduce, rename, or adjust policy behavior and ensure they follow the expected VS Code architecture.
  • Artifact Generation: Support the export workflow that regenerates policy catalogs and platform-specific policy artifacts for Windows, macOS, and Linux.
  • Use Case: A maintainer updates a setting to be centrally managed and uses this Skill to confirm the policy field, validation steps, and export process are all correct.

Quick Start

Use the add-policy skill to review a configuration change and tell me whether it needs a new policy field, the correct policy metadata, and the required validation and export steps.

Frequently Asked Questions about add-policy

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

FAQPage Schema
How do I add enterprise-managed configuration policies in VS Code?

To add VS Code configuration policies, you need to register the correct policy metadata for your setting, including category, version gating, and localization, then validate the TypeScript definitions to ensure enterprise-controlled settings behave correctly.

What is the process for exporting VS Code policies for Windows, macOS, and Linux?

Exporting VS Code policies involves regenerating platform-specific policy artifacts and policy catalogs. This workflow ensures that enterprise-managed configuration settings are properly distributed across Windows, macOS, and Linux operating systems.

How does VS Code policy registration handle version gating and localization?

VS Code policy registration uses metadata to define the correct category, version gating, and localization for a configuration setting. This ensures enterprise-controlled settings apply correctly across supported platforms and account-based policy sources.

Do I need TypeScript validation when updating VS Code configuration policies?

Yes, TypeScript validation is required when updating VS Code configuration policies. It ensures that the policy field, metadata, and enterprise-controlled settings follow the expected VS Code architecture before platform-specific artifacts are regenerated.

Can I review VS Code policy lifecycle changes for renamed or adjusted settings?

You can review VS Code policy lifecycle changes by evaluating modifications that introduce, rename, or adjust policy behavior. This process confirms that the changes follow the expected VS Code architecture and validate correctly.

Why are my VS Code enterprise policies not applying correctly across different platforms?

VS Code enterprise policies may fail to apply correctly if the policy metadata lacks proper version gating, fails TypeScript validation, or if platform-specific policy artifacts were not regenerated for Windows, macOS, and Linux distribution.