VS Code Extension Link Portability

Refactor non-portable extension paths in VS Code settings.json to tilde-based references.

1|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/Baneeishaque/ai-suite --skill vs-code-extension-link-portability
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: VS Code Extension Link Portability
Source: https://github.com/Baneeishaque/ai-suite/tree/main/.agents/skills/vscode_extension_portability
Command: npx skills add https://github.com/Baneeishaque/ai-suite --skill vs-code-extension-link-portability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

VS Code often stores extension-generated paths in settings.json that are machine-specific and non-portable. This leads to broken references after environment changes or when sharing configurations.

Core Features & Use Cases

  • Detection & Refactor: Identifies extension-created paths that rely on temporary caches or absolute user prefixes and normalizes them.
  • Portable Mapping: Rewrites paths to use the tilde home reference (e.g., ~) and redirects to a stable internal storage location for extensions.
  • Use Case: Migrating a developer profile to a new machine or sharing a VS Code setup across teammates without breaking links.

Quick Start

Execute the refactor script against your settings.json to rewrite non-portable extension paths to portable tilde-based references.

Frequently Asked Questions about VS Code Extension Link Portability

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

FAQPage Schema
How do I fix non-portable VS Code extension paths in settings.json?▼

To fix non-portable VS Code extension paths in settings.json, identify and refactor machine-specific paths generated by extensions, replacing temporary cache directories or absolute home prefixes with tilde-based references mapped to a stable internal storage location.

Why do my VS Code settings break with absolute paths like /Users or /var/folders after migrating machines?▼

VS Code settings break after migrating machines because extensions often store absolute paths like /Users or temporary /var/folders caches in settings.json, creating machine-specific references that fail when the environment changes or configurations are shared.

What is the best way to make VS Code extension configurations portable across different machines?▼

The best way to make VS Code extension configurations portable is to rewrite non-portable absolute paths in settings.json to use tilde home references, redirecting extension links to a stable internal directory such as ~/.antigravity/extensions/.

Does VS Code settings portability require mapping to a specific internal extension directory?▼

Yes, VS Code settings portability requires mapping refactored paths to a stable internal extension directory, such as ~/.antigravity/extensions/, to satisfy portability requirements and ensure extension links remain intact across different environments.

Can I refactor temporary cache directories out of my VS Code settings.json automatically?▼

Yes, you can refactor temporary cache directories out of VS Code settings.json by executing a refactor script that targets paths generated by extensions and normalizes them into portable tilde-based references for consistent configuration sharing.