vscode-extension-publishing

Automate building, packaging, and publishing VS Code extensions to the Marketplace.

1|Updated Jun 11, 2026
One-click install
npx skills add https://github.com/sergeyitaly/claude-skill-deployer --skill vscode-extension-publishing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vscode-extension-publishing
Source: https://github.com/sergeyitaly/claude-skill-deployer/tree/main/skills_library/vscode-extension-publishing
Command: npx skills add https://github.com/sergeyitaly/claude-skill-deployer --skill vscode-extension-publishing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publishing a VS Code extension to the Marketplace involves navigating complex manifest requirements, versioning rules, publisher setup, and common tooling errors that block releases for even experienced developers. This Skill eliminates that friction by providing a clear, step-by-step guided workflow for the entire publish process.

Core Features & Use Cases

  • Full publish workflow guidance: Covers package.json manifest setup, .vscodeignore configuration, local testing via Extension Development Host, vsce packaging, and Marketplace publishing.
  • Error resolution: Addresses the most common vsce failures, including missing manifest fields, version conflicts, and icon format issues.
  • Use case: If you have finished building a VS Code extension and are stuck on a "Version already exists" error or can't get your .vsix file to package correctly, this Skill walks you through fixing the issue and completing your release.

Quick Start

Use the vscode-extension-publishing skill to resolve your vsce publish error and successfully release your extension to the VS Code Marketplace after verifying your manifest and version are correctly configured.

Frequently Asked Questions about vscode-extension-publishing

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

FAQPage Schema
How do I package and publish a VS Code extension to the Marketplace?

To package and publish a VS Code extension, you validate the package.json manifest, configure .vscodeignore, test locally in the Extension Development Host, and use the @vscode/vsce toolchain to package a .vsix file and publish. This workflow ensures compliant Marketplace release.

Why does vsce publish fail with a Version already exists error?

The vsce publish Version already exists error happens when uploading a VSIX package with a version number already present on the Marketplace. You must apply semantic version bumping in package.json before repackaging and attempting to publish the VS Code extension again.

How do I set up a publisher Personal Access Token for vsce?

Setting up a publisher Personal Access Token (PAT) for vsce involves creating a token in your Microsoft account and securely providing it to the vsce publish command. This token handles publisher authentication and grants access to push extensions to the Marketplace.

What are common vsce package errors and how do I fix them?

Common vsce package errors include missing manifest fields in package.json and incorrect icon format issues. Fixing these errors requires updating the manifest with required metadata and ensuring icons meet format specifications before retrying the VSIX packaging process.

Do I need to configure .vscodeignore before building a VSIX file?

Configuring .vscodeignore before building a VSIX file is necessary to exclude unnecessary files from the package. This reduces the final extension size and prevents sensitive local files from being bundled into your published VS Code extension.