Vscode Ext Localization

Localize VS Code extensions for global reach

✨ The solution you've been looking for

Verified
Tested and verified by our team
17580 Stars

Guidelines for proper localization of VS Code extensions, following VS Code extension development guidelines, libraries and good practices

vscode localization i18n extensions development multi-language package-json typescript
Repository

See It In Action

Interactive preview & real-world examples

Live Demo
Skill Demo Animation

AI Conversation Simulator

See how users interact with this skill

User Prompt

I need to localize my VS Code extension's settings and commands for Spanish and French users. The settings are defined in package.json.

Skill Processing

Analyzing request...

Agent Response

Step-by-step guidance on creating package.nls.es.json and package.nls.fr.json files with properly structured translations for all configuration elements

Quick Start (3 Steps)

Get up and running in minutes

1

Install

claude-code skill install vscode-ext-localization

claude-code skill install vscode-ext-localization
2

Config

3

First Trigger

@vscode-ext-localization help

Commands

CommandDescriptionRequired Args
@vscode-ext-localization localizing-extension-settingsAdd multi-language support to your VS Code extension's configuration settings and commandsNone
@vscode-ext-localization translating-extension-messagesLocalize user-facing messages and strings in your extension's TypeScript/JavaScript codeNone
@vscode-ext-localization localizing-walkthrough-contentCreate multi-language versions of your extension's walkthrough and tutorial contentNone

Typical Use Cases

Localizing Extension Settings

Add multi-language support to your VS Code extension's configuration settings and commands

Translating Extension Messages

Localize user-facing messages and strings in your extension's TypeScript/JavaScript code

Localizing Walkthrough Content

Create multi-language versions of your extension's walkthrough and tutorial content

Overview

VS Code extension localization

This skill helps you localize every aspect of VS Code extensions

When to use this skill

Use this skill when you need to:

  • Localize new or existing contributed configurations (settings), commands, menus, views or walkthroughs
  • Localize new or existing messages or other string resources contained in extension source code that are displayed to the end user

Instructions

VS Code localization is composed by three different approaches, depending on the resource that is being localized. When a new localizable resource is created or updated, the corresponding localization for all currently available languages must be created/updated.

  1. Configurations like Settings, Commands, Menus, Views, ViewsWelcome, Walkthrough Titles and Descriptions, defined in package.json -> An exclusive package.nls.LANGID.json file, like package.nls.pt-br.json of Brazilian Portuguese (pt-br) localization
  2. Walkthrough content (defined in its own Markdown files) -> An exclusive Markdown file like walkthrough/someStep.pt-br.md for Brazilian Portuguese localization
  3. Messages and string located in extension source code (JavaScript or TypeScript files) -> An exclusive bundle.l10n.pt-br.json for Brazilian Portuguese localization

What Users Are Saying

Real feedback from the community

Environment Matrix

Dependencies

VS Code Extension Development Kit
Node.js (for extension development)

Framework Support

VS Code Extension API ✓ (required) TypeScript ✓ (recommended) JavaScript ✓

Context Window

Token Usage ~1K-3K tokens for standard localization tasks

Security & Privacy

Information

Author
github
Updated
2026-01-30
Category
ide-plugins