vscode-config

Resolve VS Code-family configuration paths, precedence, and ignored JSONC settings.

Updated Nov 12, 2025
One-click install
npx skills add https://github.com/artagon/artagon-vscode-profiles --skill vscode-config-artagon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vscode-config
Source: https://github.com/artagon/artagon-vscode-profiles/tree/main/agents/skills/vscode-config
Command: npx skills add https://github.com/artagon/artagon-vscode-profiles --skill vscode-config-artagon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, awk, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It helps you figure out where VS Code (and its variants like Cursor, Windsurf, VSCodium, Code-OSS, and Insiders) stores your configuration and why a setting, extension recommendation, task/debug config, or profile-specific value isn’t taking effect.

Core Features & Use Cases

  • Settings precedence and scope debugging: Explains configuration-layer precedence (Default → User → Remote → Workspace → Workspace Folder) and setting-declared scope constraints like application and machine that can silently override workspace attempts.
  • Correct file locations across OSes and variants: Provides authoritative paths for user files, profiles, .vscode/ per-project files, argv.json, extensions folders, and remote settings locations.
  • Migration and validation workflows: Guides cross-variant migration, multi-root workspace file organization, and safe JSONC handling with bundled validation/auditing/diff tools for VS Code config JSONC files.

Quick Start

Ask the vscode-config skill where your setting should be defined and what exact VS Code-family file path to check for your OS, variant, profile, and remote context.

Frequently Asked Questions about vscode-config

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

FAQPage Schema
Why is my VS Code settings.json being ignored or overridden?

VS Code settings precedence follows Default, User, Remote, Workspace, then Workspace Folder layers, meaning workspace folder values override user settings unless a setting's declared scope restricts it. Check remote settings layers and enterprise policy overrides if values still fail to apply.

Where does Cursor or VSCodium store user profiles and configuration files on Windows?

Cursor, VSCodium, Windsurf, and Insiders store user configuration in variant-specific directories that differ from standard VS Code paths. You need authoritative OS-specific file-location knowledge to find user files, named profiles, argv.json, and extensions folders accurately.

How do I migrate VS Code extensions and settings to a different variant like Windsurf?

Migrate VS Code settings to variants like Windsurf by mapping the correct cross-variant file locations for user data, profiles, and extensions folders, then validating the JSONC configuration files to ensure format compatibility before loading them in the new editor.

Does VS Code settings.json support comments with standard JSON validation?

VS Code settings.json uses JSONC (JSON with Comments) format, which standard JSON validators will reject. You need JSONC-aware parsing and validation tools to correctly audit, diff, and validate VS Code configuration files without failing on trailing commas or comments.

How do I debug VS Code launch.json and tasks.json in a multi-root workspace?

Debug launch.json and tasks.json in multi-root workspaces by organizing workspace file structures correctly and verifying that per-project .vscode/ configurations do not conflict with workspace folder precedence layers. Use bundled auditing tools to validate the JSONC syntax.

Can enterprise policy override my VS Code workspace settings?

Enterprise policy can override VS Code workspace settings by enforcing machine or application scoped configurations at a higher precedence layer. Check your OS-specific policy files and remote settings layers to diagnose why local configuration changes are not taking effect.