GitHub Actions Templates
bartstc/vite-ts-react-template
Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications.
WebSpatial SDK 仓库的版本发布与 Changesets 使用规范. An agent skill from webspatial/webspatial-sdk.
Install Webspatial Release
$ npx skills add webspatial/webspatial-sdk --skill webspatial-release -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install webspatial/webspatial-sdk webspatial-release --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/webspatial/webspatial-sdk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.coco/skills/webspatial-release .claude/skills/webspatial-release && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "webspatial-release" agent skill from https://github.com/webspatial/webspatial-sdk/tree/main/.coco/skills/webspatial-release into .claude/skills/webspatial-release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "webspatial-release", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/webspatial/webspatial-sdk/tree/main/.coco/skills/webspatial-releaseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add webspatial/webspatial-sdk --skill webspatial-release -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install webspatial/webspatial-sdk webspatial-release --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/webspatial/webspatial-sdk.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.coco/skills/webspatial-release .agents/skills/webspatial-release && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "webspatial-release" agent skill from https://github.com/webspatial/webspatial-sdk/tree/main/.coco/skills/webspatial-release into .agents/skills/webspatial-release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "webspatial-release", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add webspatial/webspatial-sdk --skill webspatial-release -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install webspatial/webspatial-sdk webspatial-release --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/webspatial/webspatial-sdk.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.coco/skills/webspatial-release .cursor/skills/webspatial-release && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "webspatial-release" agent skill from https://github.com/webspatial/webspatial-sdk/tree/main/.coco/skills/webspatial-release into .cursor/skills/webspatial-release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "webspatial-release", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/webspatial/webspatial-sdk.git --path .coco/skills/webspatial-release--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add webspatial/webspatial-sdk --skill webspatial-release -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install webspatial/webspatial-sdk webspatial-release --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/webspatial/webspatial-sdk.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.coco/skills/webspatial-release .gemini/skills/webspatial-release && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "webspatial-release" agent skill from https://github.com/webspatial/webspatial-sdk/tree/main/.coco/skills/webspatial-release into .gemini/skills/webspatial-release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "webspatial-release", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install webspatial/webspatial-sdk webspatial-releaseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add webspatial/webspatial-sdk --skill webspatial-release -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/webspatial/webspatial-sdk.git skills-src && mkdir -p .github/skills && cp -r skills-src/.coco/skills/webspatial-release .github/skills/webspatial-release && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "webspatial-release" agent skill from https://github.com/webspatial/webspatial-sdk/tree/main/.coco/skills/webspatial-release into .github/skills/webspatial-release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "webspatial-release", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add webspatial/webspatial-sdk --skill webspatial-release -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install webspatial/webspatial-sdk webspatial-release --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/webspatial/webspatial-sdk.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.coco/skills/webspatial-release .opencode/skills/webspatial-release && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "webspatial-release" agent skill from https://github.com/webspatial/webspatial-sdk/tree/main/.coco/skills/webspatial-release into .opencode/skills/webspatial-release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "webspatial-release", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
webspatial-release- GitHub stars
- 152
- Token cost
- ~836 tokens
- SKILL.md length
- 270 words
- Files
- 1
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
WebSpatial SDK 仓库的版本发布与 Changesets 使用规范. An agent skill from webspatial/webspatial-sdk.
- Works in 4 steps: stable push 后没有触发发布 → 发布没有产出新版本 → fixed 组版本不一致 → …
- DevOps & Cloud work in your project
- SKILL.md covers English quick guide, 关键约定（务必先读）, 什么时候需要 Changeset and Changeset 如何写（建议模板）, plus 5 more sections
- Calls pnpm and changeset
What it does
Webspatial Release is an agent skill from webspatial/webspatial-sdk. WebSpatial SDK 仓库的版本发布与 Changesets 使用规范。 当你需要给 @webspatial/ 包发版、准备 stable 发布、做 alpha 预发布、或排查发版失败时使用。 Release workflow & Changesets guide for WebSpatial SDK. Use this when you need to publish @webspatial/, prepare a stable release, do an alpha pre-release, or troubleshoot release failures.
Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud. It works with pnpm, GitHub Actions and React. The repository describes itself as: Unlock native-level spatial power with the WebSpatial SDK without losing the power of the web. The licence is MIT.
When your agent uses it
- DevOps & Cloud work in your project
Example prompts
- “/webspatial-release”
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 82a765c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
pnpmchangeset
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Webspatial Release loads about 836 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 270 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from webspatial/webspatial-sdk at commit 82a765c, republished under its MIT licence (© webspatial). 270 words, ~836 tokens.
Download SKILL.mdSave it as
.claude/skills/webspatial-release/SKILL.md (or your agent's skills folder).- name
- webspatial-release
- description
- WebSpatial SDK 仓库的版本发布与 Changesets 使用规范。 当你需要给 @webspatial/* 包发版、准备 stable 发布、做 alpha 预发布、或排查发版失败时使用。 Release workflow & Changesets guide for WebSpatial SDK. Use this when you need to publish @webspatial/*, prepare a stable release, do an alpha pre-release, or troubleshoot release failures.
WebSpatial 版本发布（Changesets）
本仓库是 pnpm workspace，多包发布由 changesets 统一驱动。
English quick guide
- Release branch:
stable. Publishing workflow runs on pushes tostable. - Fixed version group: core/react/builder/platform packages are versioned together.
- Commands:
pnpm changeset,pnpm ci:publish,pnpm changeset:pre-enter,pnpm changeset:pre-exit. - After publish: CI tags
v<version>and creates a sync PR fromstabletomain.
关键约定（务必先读）
- 发布主分支是
stable：Changesets 发布工作流仅在 push 到stable时触发（.changeset/config.json里的baseBranch也是stable）。 - 一组包固定同版本：
@webspatial/core-sdk、@webspatial/react-sdk、@webspatial/builder、@webspatial/platform-visionos属于fixed组，发布时会一起涨版本。 - 主分支
main会被自动同步：stable 发布成功后，CI 会自动创建 “Merge stable into main” 的同步 PR（见.github/workflows/changesets.yml）。
什么时候需要 Changeset
以下情况 必须 加 .changeset/*.md：
- 修改了任何
packages/*中的可发布内容（对外 API、类型、行为、构建产物）。 - 修复 bug / 新增特性 / 性能优化，且会影响用户。
以下情况 可以不加（但要确认不影响发布包）：
- 仅改 demo（
apps/test-server）、仅改测试（不影响发布包）、仅改 CI。 - 纯内部重构且不改变对外行为（建议仍加 patch，避免漏发）。
Changeset 如何写（建议模板）
在仓库根目录执行：
pnpm changeset选择要发布的包与版本类型：
- patch：bugfix、小改动、兼容性增强（新增可选字段、修复边界条件）。
- minor：向后兼容的新能力（新增 API、默认行为不变但能力增强）。
- major：破坏性变更（删除/重命名 API、行为不兼容、强制迁移）。
正文建议包含：
- 变更点一句话（what）
- 影响与原因（why）
- 迁移说明（如有）
发布前自检（发版人/合入前都应做）
在仓库根目录：
pnpm install
pnpm run buildPackages
pnpm test如果你改动涉及 React/事件/类型：
- 确认类型导出路径与
exports没破坏（尤其是packages/react/package.json）。 - 对事件新增字段，优先做“向后兼容”（新增可选字段），并补单测覆盖。
正式发布流程（stable 发布）
- 确保本次要发布的改动都已在 PR 中合入，并且 changeset 已齐全。
- 将
main的发布内容合入stable（团队按既定流程：merge / cherry-pick / PR）。 - 当
stable有新的 push：- GitHub Actions
Changesets工作流会自动运行（.github/workflows/changesets.yml）。 - 它会先尝试创建 “chore: update versions” 的版本 PR；
- 合并后会执行
changeset publish（脚本pnpm ci:publish），并推送v<version>tag； - 发布成功后会自动创建 stable → main 的同步 PR。
- GitHub Actions
发布结果确认（建议）
- 在 GitHub Release / Tags 中确认出现
v<version>。 - 在 npm 上确认
@webspatial/*对应版本已更新。 - 如使用 Preview Release，确认临时包已失效或无误。
预发布（alpha）
仓库提供了 alpha 预发布命令：
pnpm changeset:pre-enter
pnpm changeset:pre-exit建议用法：
- 当需要给少量用户验证变更时，进入
alpha预发布模式，生成 alpha 版本号，验证后退出。 - 注意：预发布仍应遵循 Changeset 规范，避免出现“发了 alpha 但忘记写 changeset”的情况。
预览发布（PR/分支的临时包）
仓库有 Preview release 工作流（.github/workflows/preview-release.yml），用于在 PR 上产出临时包。
- 触发方式：给 PR 打上标签
trigger: preview（或 push 到main/stable时满足条件）。 - 作用：把
./packages/*发布成临时可安装版本，便于联调验证（通过pkg-pr-new）。
常见故障排查
1) stable push 后没有触发发布
- 确认目标分支是
stable（不是main）。 - 确认 GitHub Actions 工作流是否被禁用。
2) 发布没有产出新版本
- 大概率是本次合入没有 changeset，或 changeset 被误删。
- 检查
.changeset/目录是否存在本次变更对应的 md 文件。
3) fixed 组版本不一致
- 本仓库配置为 fixed 组，理论上不应不一致。
- 若出现，检查
.changeset/config.json的fixed配置是否被误改，或是否存在手动改版本号的提交。
4) 版本 PR 生成了但 publish 失败
- 先看 CI 日志里
pnpm run setup是否成功（构建失败会导致 publish 失败）。 - 再看 npm 鉴权/权限问题（工作流使用 OIDC，相关问题需要在 CI 侧修复）。
© webspatial, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .coco/skills/webspatial-release of webspatial/webspatial-sdk.
Open the folder on GitHubat commit 82a765c
Compare with similar skills
Webspatial Release next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Webspatial Release this skillwebspatial/webspatial-sdk | 152 | — | ~836 | Automated safety check: Pass | MIT | |
| GitHub Actions Templatesbartstc/vite-ts-react-template | 122 | 14 repos | ~1.9k | Automated safety check: Pass | MIT | |
| CI GitHub Actionsgnomeria/usbtree | 691 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Release Flowromankurnovskii/BrewMate | 300 | — | ~976 | Automated safety check: Pass | MIT | |
| Deploy Release Testvercel/next.js | 143k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Code PatternsAedelon/claude-code-blueprint | 120 | — | ~1.2k | Automated safety check: Pass | Custom licence |
Similar skills
CI GitHub Actions
gnomeria/usbtree
GitHub Actions CI pipeline conventions — job shape, caching, permissions, and action pinning.
Release Flow
romankurnovskii/BrewMate
Automate the full application release flow for BrewMate, including committing local changes, bumping version, waiting for GitHub Actions release build, and pushing the in-repo cask update…
- Official
Deploy Release Test
vercel/next.js
Validate a commit-specific Next.js preview package and manually trigger the entire Next.js deployment test suite through the teste2edeployrelease.yml GitHub Actions workflow.
Code Patterns
Aedelon/claude-code-blueprint
Reference patterns for REST APIs, pytest/vitest testing, Docker multi-stage builds, GitHub Actions CI/CD, PostgreSQL, TypeScript generics, Python async, and React Server Components.
Novu Framework Integration
novuhq/novu
Build code-first notification workflows with @novu/framework.
More from webspatial/webspatial-sdk
Webspatial Avp Iwdp
webspatial/webspatial-sdk
Programmatic WebSpatial debugging on the Apple Vision Pro simulator via ios-webkit-debug-proxy and tools/scripts/iwdp-sim.py.
Related
Works with
Categories
Questions about Webspatial Release
What does Webspatial Release do?
WebSpatial SDK 仓库的版本发布与 Changesets 使用规范. An agent skill from webspatial/webspatial-sdk. Webspatial Release is an agent skill from webspatial/webspatial-sdk. WebSpatial SDK 仓库的版本发布与 Changesets 使用规范。 当你需要给 @webspatial/ 包发版、准备 stable 发布、做 alpha 预发布、或排查发版失败时使用。 Release workflow & Changesets guide for WebSpatial SDK.
When should I use Webspatial Release?
Webspatial Release fits situations like: devOps & Cloud work in your project.
How do I install Webspatial Release in Claude Code?
Run `npx skills add webspatial/webspatial-sdk --skill webspatial-release -a claude-code`. Or copy the skill folder (.coco/skills/webspatial-release in webspatial/webspatial-sdk) into .claude/skills/webspatial-release in your project. Claude Code loads it when a task matches its description.
How do I install Webspatial Release in Codex?
Run `npx skills add webspatial/webspatial-sdk --skill webspatial-release -a codex`. Or copy the skill folder (.coco/skills/webspatial-release in webspatial/webspatial-sdk) into .agents/skills/webspatial-release in your project. Codex loads it when a task matches its description.
Can I use Webspatial Release in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add webspatial/webspatial-sdk --skill webspatial-release -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/webspatial-release, .gemini/skills/webspatial-release, .github/skills/webspatial-release and .opencode/skills/webspatial-release in your project.
What does Webspatial Release need to run?
Going by SKILL.md and its folder, Webspatial Release needs the command-line tools its instructions call (pnpm and changeset).
Does Webspatial Release access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Webspatial Release safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Webspatial Release use?
Webspatial Release is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Webspatial Release use?
About 836 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Webspatial Release?
Skills that share tags, products or a category with Webspatial Release: GitHub Actions Templates (bartstc/vite-ts-react-template, 122 stars), CI GitHub Actions (gnomeria/usbtree, 691 stars), Release Flow (romankurnovskii/BrewMate, 300 stars) and Deploy Release Test (vercel/next.js, 143k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Webspatial Release?
webspatial (a GitHub organization) maintains it in webspatial/webspatial-sdk, which has 152 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 10, 2026.
Source: webspatial/webspatial-sdk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.