Cursor BYOK Desktop Release
leookun/cursor-byok
Guides releases of the Cursor BYOK desktop app on GitHub, with strict rules on who may publish and how version tags, updater manifests and signing are handled.
Use BEFORE preparing or publishing any Hermes Agent CN Desktop release (new installer, version bump, GitHub Release, or publishing a new build to users).
Install Desktop Release Preflight
$ npx skills add Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Eynzof/Hermes-CN-Desktop desktop-release-preflight --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/Eynzof/Hermes-CN-Desktop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/desktop-release-preflight .claude/skills/desktop-release-preflight && 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 "desktop-release-preflight" agent skill from https://github.com/Eynzof/Hermes-CN-Desktop/tree/main/.codex/skills/desktop-release-preflight into .claude/skills/desktop-release-preflight/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "desktop-release-preflight", 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/Eynzof/Hermes-CN-Desktop/tree/main/.codex/skills/desktop-release-preflightType 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 Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Eynzof/Hermes-CN-Desktop desktop-release-preflight --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Eynzof/Hermes-CN-Desktop.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.codex/skills/desktop-release-preflight .agents/skills/desktop-release-preflight && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "desktop-release-preflight" agent skill from https://github.com/Eynzof/Hermes-CN-Desktop/tree/main/.codex/skills/desktop-release-preflight into .agents/skills/desktop-release-preflight/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "desktop-release-preflight", 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 Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Eynzof/Hermes-CN-Desktop desktop-release-preflight --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Eynzof/Hermes-CN-Desktop.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.codex/skills/desktop-release-preflight .cursor/skills/desktop-release-preflight && 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 "desktop-release-preflight" agent skill from https://github.com/Eynzof/Hermes-CN-Desktop/tree/main/.codex/skills/desktop-release-preflight into .cursor/skills/desktop-release-preflight/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "desktop-release-preflight", 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/Eynzof/Hermes-CN-Desktop.git --path .codex/skills/desktop-release-preflight--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 Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Eynzof/Hermes-CN-Desktop desktop-release-preflight --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Eynzof/Hermes-CN-Desktop.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.codex/skills/desktop-release-preflight .gemini/skills/desktop-release-preflight && 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 "desktop-release-preflight" agent skill from https://github.com/Eynzof/Hermes-CN-Desktop/tree/main/.codex/skills/desktop-release-preflight into .gemini/skills/desktop-release-preflight/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "desktop-release-preflight", 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 Eynzof/Hermes-CN-Desktop desktop-release-preflightInstalls 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 Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Eynzof/Hermes-CN-Desktop.git skills-src && mkdir -p .github/skills && cp -r skills-src/.codex/skills/desktop-release-preflight .github/skills/desktop-release-preflight && 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 "desktop-release-preflight" agent skill from https://github.com/Eynzof/Hermes-CN-Desktop/tree/main/.codex/skills/desktop-release-preflight into .github/skills/desktop-release-preflight/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "desktop-release-preflight", 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 Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Eynzof/Hermes-CN-Desktop desktop-release-preflight --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Eynzof/Hermes-CN-Desktop.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.codex/skills/desktop-release-preflight .opencode/skills/desktop-release-preflight && 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 "desktop-release-preflight" agent skill from https://github.com/Eynzof/Hermes-CN-Desktop/tree/main/.codex/skills/desktop-release-preflight into .opencode/skills/desktop-release-preflight/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "desktop-release-preflight", 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
desktop-release-preflight- GitHub stars
- 1.8k
- Token cost
- ~1.6k tokens
- SKILL.md length
- 395 words
- Files
- 2
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Use BEFORE preparing or publishing any Hermes Agent CN Desktop release (new installer, version bump, GitHub Release, or publishing a new build to users).
- Works in 9 steps: ☑️ identifier 没改：grep identifier… → ☑️ bundled_runtime_tag 锁到 ≥ 线上 stable 最高… → ☑️ 本次不 bump MANIFEST_SCHEMA_VERSION（保持… → …
- Tasks that involve CI/CD
- SKILL.md covers Overview, 为什么覆盖升级默认安全（一句话原理）, 发版前必过 checklist（按顺序逐条勾） and 两个必须主动防的坑（深入）, plus 4 more sections
- Calls pnpm and gh
What it does
Desktop Release Preflight is an agent skill from Eynzof/Hermes-CN-Desktop. Use BEFORE preparing or publishing any Hermes Agent CN Desktop release (new installer, version bump, GitHub Release, or publishing a new build to users). This is the release safety gate that prevents in-place overwrite-upgrade regressions for existing users (live users are mainly on v0.3.2 and upgrade by downloading the new installer over the old one). Covers the managed-runtime reconcile traps (silent kernel downgrade via bundledruntimetag, schemaVersion re-bootstrap, the load-bearing stable bundle identifier)…
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).
It sits in DevOps & Cloud, covering CI/CD and Deployment. It works with GitHub Actions, GitHub and Tauri. The repository describes itself as: Hermes Agent CN desktop app, Windows-First, built with Tauri, Typescript and Rust. Isolated Hermes Agent core insides.
When your agent uses it
- Tasks that involve CI/CD
- Tasks that involve Deployment
Example prompts
- “artifactUrl-before-signing”
- “/desktop-release-preflight”
Workflow steps
9 steps, taken from the first numbered list in SKILL.md.
- ☑️ identifier 没改：grep identifier tauri.conf.json 仍是 cn.org.hermesagent.desktop。永不更改。
- ☑️ bundled_runtime_tag 锁到 ≥ 线上 stable 最高 runtime，且是明确版本（不是 latest）。这是防内核静默降级的关键（见下"坑 1"）。
- ☑️ 本次不 bump MANIFEST_SCHEMA_VERSION（保持 runtime.rs:29 的 2）。schema→3（强升门改造）单独排期（见"坑 2"）。
- ☑️ macOS 走完公证/装订（release-desktop.yml:153-293）。未公证会被 Gatekeeper 拦。
- ☑️ Windows 现状未签名（无 Authenticode）→ 覆盖装会触发 SmartScreen。发版说明里明确告知用户点"仍要运行"，或本次补 Authenticode（见 docs/hot-update.md §9）。
- ☑️ 版本号同步：改根 package.json "version" 后 pnpm run version:sync，pnpm version:check 通过（这步与 desktop-release-sync-landing 重叠，以那篇为准）。
- ☑️ 发版说明提示"安装前先退出正在运行的桌面端"（外壳 .exe/.app 文件锁；dashboard 子进程在 app-data 不被锁）。
- ☑️ 先发 canary 给开发团队覆盖装验证（见下"灰度优先"），确认 reconcile 行为符合预期，再放 stable。
- ☑️ stable/正式公开版本发完后转 desktop-release-sync-landing：同步 landing 官网版本 + https://desktop.hermesagent.org.cn/latest.json。RC / beta / alpha /…
What it can do on your machine
Read from SKILL.md and the folder at commit 06e15d0. 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:
pnpmgh
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
docs.cnb.cool
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
Desktop Release Preflight loads about 1.6k tokens when it runs. Until then it costs about 222 tokens; SKILL.md has 395 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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:20
| 配置 / profiles / 会话 / `.env` / `HERMES_HOME` | app-data | **保留** |
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
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 395 words (~1,551 tokens).
“线上用户主力是 v0.3.2，外壳尚无自更新（热更新轨道 C 未建），所以用户升级 = 下载新安装包直接覆盖装。这套机制默认是安全的——用户的内核 runtime 树和所有设置都在 app-data、不在安装目录，覆盖装不动它们；启动时 install_bundled_runtime_if_needed 自动 reconcile。但有两个坑会在不经意间伤到老用户，必须每次发版主动防。 本技能就是发版前的安全闸门；只有 stable/正式公开版本才在本技能之后执行 desktop-release-sync-landing。”
- name
- desktop-release-preflight
Files
SKILL.md and 1 other file in .codex/skills/desktop-release-preflight of Eynzof/Hermes-CN-Desktop.
- SKILL.md
- agents/openai.yaml
Open the folder on GitHubat commit 06e15d0
Compare with similar skills
Desktop Release Preflight 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 |
|---|---|---|---|---|---|---|
| Desktop Release Preflight this skillEynzof/Hermes-CN-Desktop | 1.8k | — | ~1.6k | Automated safety check: Notes | Custom licence | |
| Cursor BYOK Desktop Releaseleookun/cursor-byok | 3.2k | — | ~1.3k | Automated safety check: Pass | MIT | |
| AI News RadarLearnPrompt/ai-news-radar | 1.8k | — | ~2.5k | Automated safety check: Notes | MIT | |
| Use Vercel Actionamondnet/vercel-action | 764 | — | ~2.7k | Automated safety check: Pass | MIT | |
| Prepare Cloudflare Production DeploymentLubomirGeorgiev/cloudflare-workers-nextjs-saas-template | 786 | — | ~5.9k | Automated safety check: Notes | MIT | |
| GitHub Actions Docsdevantler-tech/ksail | 165 | 2 repos | ~1.3k | Automated safety check: Pass | Custom licence |
Similar skills
AI News Radar
LearnPrompt/ai-news-radar
A skill your agent uses when working on AI News Radar, 24 小时 AI 更新雷达, AI 更新雷达, 伯乐Skill, or Scout Skill: finding high-signal AI/tech sources, adding RSS/OPML/GitHub feeds, checking source health…
Use Vercel Action
amondnet/vercel-action
Wire amondnet/vercel-action into a GitHub Actions workflow to deploy Vercel projects from CI.
Prepare Cloudflare Production Deployment
LubomirGeorgiev/cloudflare-workers-nextjs-saas-template
Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.
GitHub Actions Docs
devantler-tech/ksail
A skill your agent uses when users ask how to write, explain, customize, migrate, secure, or troubleshoot GitHub Actions workflows, workflow syntax, triggers, matrices, runners, reusable workflows…
CI CD
EliasOulkadi/shokunin
Design CI/CD pipelines for GitHub Actions, GitLab CI, and CircleCI with matrix builds, test sharding, caching, Docker layer caching, OIDC auth, deployment strategies (rolling, blue-green, canary)…
More from Eynzof/Hermes-CN-Desktop
Desktop Dual Repo Test
Eynzof/Hermes-CN-Desktop
A skill your agent uses when starting or verifying Hermes Agent CN Desktop with the latest Hermes-CN-Desktop and Hermes-CN-Core branches — dev smoke test (pnpm tauri:dev), packaged beta/release…
Desktop Release Sync Landing
Eynzof/Hermes-CN-Desktop
Use only for stable/public Hermes Agent CN Desktop releases that should be visible to all users.
Project Structure
Eynzof/Hermes-CN-Desktop
A skill your agent uses when orienting within the Hermes Agent CN Desktop codebase, locating source files, understanding the Tauri+React architecture, finding Rust commands or frontend modules, or…
Related
Works with
Categories
Questions about Desktop Release Preflight
What does Desktop Release Preflight do?
Use BEFORE preparing or publishing any Hermes Agent CN Desktop release (new installer, version bump, GitHub Release, or publishing a new build to users). Desktop Release Preflight is an agent skill from Eynzof/Hermes-CN-Desktop. Use BEFORE preparing or publishing any Hermes Agent CN Desktop release (new installer, version bump, GitHub Release, or publishing a new build to users).
When should I use Desktop Release Preflight?
Desktop Release Preflight fits situations like: tasks that involve CI/CD; tasks that involve Deployment.
How do I install Desktop Release Preflight in Claude Code?
Run `npx skills add Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a claude-code`. Or copy the skill folder (.codex/skills/desktop-release-preflight in Eynzof/Hermes-CN-Desktop) into .claude/skills/desktop-release-preflight in your project. Claude Code loads it when a task matches its description.
How do I install Desktop Release Preflight in Codex?
Run `npx skills add Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a codex`. Or copy the skill folder (.codex/skills/desktop-release-preflight in Eynzof/Hermes-CN-Desktop) into .agents/skills/desktop-release-preflight in your project. Codex loads it when a task matches its description.
Can I use Desktop Release Preflight 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 Eynzof/Hermes-CN-Desktop --skill desktop-release-preflight -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/desktop-release-preflight, .gemini/skills/desktop-release-preflight, .github/skills/desktop-release-preflight and .opencode/skills/desktop-release-preflight in your project.
What does Desktop Release Preflight need to run?
Going by SKILL.md and its folder, Desktop Release Preflight needs the command-line tools its instructions call (pnpm and gh).
Does Desktop Release Preflight access the network?
SKILL.md names 1 domain. As links in the text: docs.cnb.cool. This is read from the text; nothing was executed.
Is Desktop Release Preflight safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Desktop Release Preflight use?
Desktop Release Preflight has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Desktop Release Preflight use?
About 1.6k tokens (SKILL.md is roughly 6.2k 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 Desktop Release Preflight?
Skills that share tags, products or a category with Desktop Release Preflight: Cursor BYOK Desktop Release (leookun/cursor-byok, 3.2k stars), AI News Radar (LearnPrompt/ai-news-radar, 1.8k stars), Use Vercel Action (amondnet/vercel-action, 764 stars) and Prepare Cloudflare Production Deployment (LubomirGeorgiev/cloudflare-workers-nextjs-saas-template, 786 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Desktop Release Preflight?
Eynzof (a GitHub user) maintains it in Eynzof/Hermes-CN-Desktop, which has 1,750 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 21, 2026.
Source: Eynzof/Hermes-CN-Desktop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.