Skip to content

docs: clarify VS Code publisher identity #41

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zzgosh merged 1 commit into from
Jun 1, 2026
Merged

docs: clarify VS Code publisher identity #41

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .agent-vendor/lock.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -156,8 +156,8 @@
"lastSeenUpstreamCommit": null,
"lastSyncedContentHash": null,
"lastSeenContentHash": null,
"localContentHash": "71cb3422e113d5db0107f9edb9776e0d5485be23",
"lastCheckedAt": "2026-05-29T05:00:55.470Z",
"localContentHash": "2ea64ffd1f22f92319be99ef0bf12bccb5d90259",
"lastCheckedAt": "2026-06-01T06:29:41.708Z",
"lastSyncedAt": null,
"status": "in_sync"
}
Expand Down
5 changes: 5 additions & 0 deletions resources/skills/vscode-extension-release/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,7 @@ Use the current official documentation for field names, package constraints, tok
Enumerate these constraints in the release guide so common first-release failures are visible. Re-verify against the docs above before each submission:

- `name` - required, all lowercase, no spaces, unique in the Marketplace; the extension ID is `${publisher}.${name}`
- `publisher` - use the Marketplace publisher ID in the manifest, not a personal or organization display name; changing `publisher` changes the extension ID
- `displayName` - must be unique in the Marketplace
- `keywords` - at most 30 entries
- `icon` - PNG, at least 128x128 pixels; 256x256 is recommended for Retina displays; SVG is not accepted for the manifest icon
Expand Down Expand Up @@ -209,6 +210,7 @@ Review:
- `displayName` as the human-readable title
- `description` as the canonical short pitch
- `name` as the immutable-looking package slug: all lowercase, no spaces, unique, and paired with `publisher` as the extension ID
- `publisher` as the Marketplace publisher ID in `package.json`; if the public listing should show a different author or organization label, handle that through the Marketplace publisher profile `Name`, not by changing the manifest `publisher`
- `keywords` as discovery tags with a hard maximum of 30 entries
- README first screen: what it does, supported contexts, install/use flow, screenshots, requirements, settings, commands, limitations, privacy, support, and license
- images and GIFs: use stable HTTPS URLs when required by the current Marketplace docs, avoid local-only broken images, and verify dimensions/rendering where relevant
Expand All @@ -224,6 +226,7 @@ When drafting copy, keep user-facing language product-focused and consistent wit
For Visual Studio Marketplace, verify:

- publisher ID and publisher ownership
- publisher profile display `Name`; document when it intentionally differs from the manifest `publisher` ID, and note that locally installed VSIX detail pages may show the manifest publisher rather than Marketplace profile-only display metadata
- Personal Access Token setup, scopes, and expiration expectations from current docs; current docs require Organization = `All accessible organizations` and Authorized Scopes = `Marketplace (Manage)`
- `@vscode/vsce` version and command syntax
- whether the release is stable, pre-release, preview, or platform-specific; for pre-release use `vsce package --pre-release` or `vsce publish --pre-release`
Expand Down Expand Up @@ -307,6 +310,7 @@ Render the checklist with explicit `[ ]` markers, grouped so the user can work t
**Manifest & compatibility**
- [ ] `publisher`, `name`, `displayName`, `description`, `version`, and `engines.vscode` are correct
- [ ] `name` is all lowercase, contains no spaces, is Marketplace-unique, and forms the intended `${publisher}.${name}` ID
- [ ] manifest `publisher` is the Marketplace publisher ID, not a display name; publisher profile `Name` is handled separately when it should differ
- [ ] `keywords` has 30 or fewer entries
- [ ] categories, keywords, icon, gallery banner, license, repository, bugs/support, and homepage are reviewed
- [ ] activation events and contributions match actual behavior
Expand Down Expand Up @@ -341,6 +345,7 @@ Render the checklist with explicit `[ ]` markers, grouped so the user can work t

**Marketplace**
- [ ] Visual Studio Marketplace publisher identity and PAT setup are ready with `All accessible organizations` and `Marketplace (Manage)`
- [ ] local VSIX publisher display expectations vs Marketplace publisher profile `Name` are documented when they differ
- [ ] package can be uploaded manually or published with confirmed `vsce` command
- [ ] release channel is decided: stable, pre-release, preview, or platform-specific
- [ ] pre-release versioning and `--pre-release` usage are correct, if applicable
Expand Down