Catalog
github/vscode-ext-localization

github

vscode-ext-localization

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

v1.0Latest
New~355Updated Jun 26, 2026

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
Files1
1 files · 1.0 KB

Select a file to preview

Overall Score

52/100

Grade

C

Adequate

Safety

85

Quality

40

Clarity

68

Completeness

32

Summary

This skill provides guidelines for localizing VS Code extensions across three distinct resource types: package.json configuration metadata, walkthrough markdown content, and source code string messages. It documents the file naming conventions and directory structure required by VS Code's localization framework.

Detected Capabilities

file readmarkdown documentation referencejson configuration reading

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

localize extensiontranslate vs code extensionadd extension translationslocalization setuplanguage support extension

Use Cases

  • Add localized settings to a VS Code extension
  • Create translated walkthrough content for non-English markets
  • Localize extension command and menu labels
  • Implement string translations in TypeScript/JavaScript source code
  • Update localization files when adding new extension features

Quality Notes

  • Skill provides clear taxonomy of three localization approaches with file naming conventions
  • Each approach is paired with concrete file path examples (package.nls.pt-br.json, walkthrough/*.md, bundle.l10n.json)
  • Skill lacks implementation details: no guidance on how to extract strings, manage translation workflows, or handle pluralization/formatting
  • No edge cases documented (e.g., what happens with dynamic strings, how to handle RTL languages, character encoding concerns)
  • Missing error handling guidance — what to do if translations are incomplete or malformed
  • Does not explain when to use each approach or provide decision criteria
  • No reference to VS Code localization APIs, l10n module, or extension manifest localization fields
  • Lacks examples of actual localization file structure and content
  • Does not address testing localized extensions or validating translation completeness
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use github/vscode-ext-localization in your dev environment

Command Palette

Search for a command to run...