awesome-vscode/CLAUDE.md

CLAUDE.md

What this repo is

An Awesome List of Visual Studio Code extensions and resources. README.md is the product — there is no source code, no build step, and no app to run. Edits almost always mean editing README.md.

Adding an entry

Use this exact format (see CONTRIBUTING.md):

#### [Title of the package](https://marketplace.visualstudio.com/items?itemName=NAME)
> A short description of what this package does and why it is awesome.

![title of the package](link to a .gif demonstrating functionality)

Rules:

• Link to the VS Code Marketplace (marketplace.visualstudio.com), not the GitHub repo.
• Place the entry in the most fitting section; if none fits, use uncategorized.
• Keep entries in alphabetical order within their section.
• Include a .gif/screenshot demonstrating functionality when possible.

Table of Contents

The ToC at the top of README.md is maintained by hand and must be updated when sections are added, removed, or renamed. Anchors are GitHub-slugified (lowercase, spaces → -, most punctuation stripped; duplicates get a -1 suffix).

Themes

• Prefer a vscodethemes link, else the Marketplace.
• Alphabetical order; one theme per publisher.
• Include a similar-style screenshot (template assets under themes/).

Linting / CI

• markdownlint config is .markdownlint.json. Several rules are disabled on purpose (HTML allowed, line-length off, duplicate headings allowed, etc.) — don't "fix" these by reformatting.
• CI (.travis.yml) runs awesome_bot README.md to check that all links resolve. Adding a dead or wrong link will fail the build. A whitelist of known-flaky domains lives in .travis.yml.

Conventions for changes

• This is a PR-driven community repo: keep diffs minimal and scoped to the entry/section being changed.
• Match the surrounding markdown style exactly (heading levels, > blockquote descriptions, spacing).
• Do not commit unless explicitly asked.