mcpField
A
arch-vscode

arch-vscode

github.com/hairyfDevelopment26103 installsUpdated 2w ago
Repository

About arch-vscode

arch-vscode is a skill for setting up VSCode extension projects from a starter based on antfu/starter-vscode. It documents an opinionated workflow using reactive-vscode, tsdown, and vscode-ext-gen, from extension entry and debugging through packaging and publishing.

Key features

  1. 01Sets up a VSCode extension starter
  2. 02Uses reactive-vscode composables
  3. 03Builds a single CJS bundle with tsdown
  4. 04Generates typed contributes metadata
  5. 05Covers debugging, packaging, and publishing

Use cases

  1. 01Starting a VSCode extension project
  2. 02Configuring extension entry and contributes
  3. 03Debugging in the Extension Host
  4. 04Preparing an extension for packaging or publishing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hairyf/skills --skill arch-vscode

After installing, type/arch-vscodein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

GENERATION.md
assets/
ci.yml
references/
best-practices-vscode-ext.md
core-ci.md
core-config.md
core-contributes.md
core-development.md
core-extension-entry.md
core-logging.md
core-overview.md
core-scripts.md
core-tsdown-build.md

Details

From the project README

arch-vscode is a VSCode extension starter (based on antfu/starter-vscode) that uses reactive-vscode for reactive APIs and composables, tsdown for a single CJS bundle, and vscode-ext-gen for type-safe contributes metadata. It provides a minimal, opinionated setup: defineExtension entry, defineConfig/defineLogger, Extension Host debugging, and vsce/vsxpub for packaging and publishing.

The skill is based on starter-vscode (arch-vscode source), generated at 2026-01-30.

Recommended practices:

  • Keep contributes and generated meta in sync via pnpm update (or Run on Save)
  • Use reactive-vscode composables for state and disposables; use CJS build with external vscode
  • Prefer onCommand activation when possible

Core References

TopicDescriptionReference
OverviewProject purpose, structure, when to usecore-overview
Extension EntrydefineExtension, activate, deactivatecore-extension-entry
ConfigdefineConfig, generated scoped configcore-config
LoggingdefineLogger, displayNamecore-logging
tsdown BuildCJS, external vscode, build:prepare hookcore-tsdown-build
Scriptsbuild, dev, update, release, ext:package, ext:publishcore-scripts
Contributescommands, configuration, activationEventscore-contributes
Developmentlaunch.json, tasks.json, Extension Hostcore-development
CIGitHub Actions workflow — lint, typecheck, build, testcore-ci

Best Practices

TopicDescriptionReference
VSCode Extensionentry, contributes, meta, activation, publishbest-practices-vscode-ext

Comments

Markdown supported