vscode-ext-localization

Localize VS Code extension resources across languages in package.json, walkthroughs, and code messages.

37.6k|4.7k|Updated Jun 11, 2025
One-click install
npx skills add https://github.com/github/awesome-copilot --skill vscode-ext-localization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vscode-ext-localization
Source: https://github.com/github/awesome-copilot/tree/main/skills/vscode-ext-localization
Command: npx skills add https://github.com/github/awesome-copilot --skill vscode-ext-localization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

VS Code extension localization is often error-prone and inconsistent across languages, causing confusing user experiences and missed UI guarantees. This skill provides structured guidelines to localize configurations, messages, and walkthrough content for VS Code extensions.

Core Features & Use Cases

  • Configuration Localization: Localize package.json fields like settings, commands, menus, and views for all target languages.
  • Walkthrough Content Localization: Localize Walkthrough titles, descriptions, and Markdown content in the extension.
  • In-Code Message Localization: Localize strings used in extension source code via localization bundles.

Quick Start

Add a new locale by creating package.nls.LANG.json, localize Walkthrough content with locale-specific Markdown files, and maintain language-specific string bundles for code access.

Frequently Asked Questions about vscode-ext-localization

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

FAQPage Schema
How do I localize a VS Code extension across multiple languages?

Localize VS Code extensions by creating language-specific resource files: add package.nls.LANG.json for configuration strings, locale-specific Markdown files for walkthroughs, and language bundles for in-code messages. This ensures consistent UI text across all target locales and delivers deterministic localization workflows.

What's the best way to handle package.json localization in VS Code extensions?

Localize package.json fields like settings, commands, menus, and views by creating package.nls.LANG.json files for each target language. VS Code reads these bundles to apply locale-aware configuration strings, enabling users to see extension UI elements in their preferred language.

Can I localize walkthrough content in VS Code extensions?

Yes. Localize walkthrough titles, descriptions, and Markdown content by creating locale-specific Markdown files alongside your extension resources. VS Code automatically serves the correct language variant based on user locale, providing language-specific walkthroughs consistently.

How do I prevent localization errors in VS Code extension strings?

Use structured language-specific string bundles (package.nls.LANG.json) and maintain locale-aware code strings through i18n patterns. This eliminates inconsistencies across languages, ensures UI guarantees are met, and prevents confusing user experiences from incomplete or mismatched translations.

Do I need separate files for each language in VS Code extension localization?

Yes. Create a separate package.nls.LANG.json file for each target language and locale-specific Markdown files for walkthrough content. This modular approach keeps language strings organized, prevents conflicts, and allows independent translation management per locale.

What files and formats does VS Code extension localization require?

VS Code extension localization requires package.nls.LANG.json files for configuration strings, locale-specific Markdown files for walkthrough content, and language-specific string bundles for source code. Together these formats enable complete i18n coverage across all extension UI surfaces.