PromptHub Release Sync
Use this skill for version bumps, release preparation, changelog or README
updates, website release sync, screenshots, and multilingual release material.
Read First
AGENTS.md
spec/releases/release-rules.md
spec/releases/README.md and the target version record, when present
package.json, workspace package manifests, and the newest relevant
CHANGELOG.md section
Do not treat this skill as a second release-policy source. Stable release
semantics belong in spec/releases/release-rules.md; this skill is the
execution procedure.
Establish Scope
Before editing, identify:
- target version and release date
- stable, prerelease, historical prerelease, or docs-only update
- affected distributions: desktop, CLI, self-hosted web, worker, mobile
- whether public copy, in-app copy, screenshots, installers, or signing changed
For non-trivial release work, create or update the matching active change
before implementation.
Source And Sync Order
- Update version-bearing manifests for affected distributions, including the
root and workspace packages when the monorepo version changes.
- Update
CHANGELOG.md and spec/releases/<version>.md.
- Sync repository-facing documentation:
README.md
docs/README.md
docs/README.en.md
docs/README.zh-TW.md
docs/README.ja.md
docs/README.de.md
docs/README.es.md
docs/README.fr.md
- Run
pnpm --dir website sync:release and inspect:
website/src/generated/release.ts
website/src/content/docs/changelog.md
website/src/content/docs/introduction.md
website/src/content/docs/en/introduction.md
- Update non-generated website copy only when the release contract changed:
website/src/i18n/ui.ts
website/src/pages/index.astro
website/src/pages/en/index.astro
- When desktop user-facing copy changed, synchronize all locale files under
apps/desktop/src/renderer/i18n/locales/.
- When visible GUI or feature emphasis changed, inspect and update matching
assets under
docs/imgs/ and website/public/imgs/.
- Synchronize durable conclusions into
spec/workflow/*, spec/knowledge/*,
spec/rules/*, or spec/adr/* only when their stable contracts changed.
Release Semantics
- Stable-facing badges, default downloads, and install instructions continue
to point to the latest stable version when preparing a prerelease.
- Historical prereleases below an existing stable version are manual testing
artifacts, not the default upgrade path.
- Do not document a GUI state without matching current UI evidence or updated
screenshots.
- Do not silently skip localized docs or locale files; record why a surface is
unaffected.
- When mentioning CLI availability, distinguish the CLI/npm distribution from
desktop-bundled behavior.
- Use the website sync command instead of hand-editing generated metadata.
Verification
Run the lowest relevant checks first, then:
pnpm verify:release:quick for local release-impacting changes
pnpm verify:release before tagging or publishing a release candidate
- platform signing/notarization checks required by
spec/releases/release-rules.md for packaged macOS artifacts
Record commands, results, skipped surfaces, and residual risks in the active
change implementation.md. The quick profile is diagnostic and does not grant
release approval.
Completion Report
Report:
- target version and release type
- affected distributions and manifests
- website sync status
- screenshot status
- updated docs and locales
- verification results
- intentionally skipped surfaces and remaining release risk
1---
2name: release-sync
3description: PromptHub release update skill. Use for `/update-readme`, version bumps, changelog updates, website sync, GUI screenshot/doc refresh, and multilingual release/documentation alignment.
4metadata:
5 source: https://skillmd.com/skills/legeling/release-sync
6---
7
8# PromptHub Release Sync
9
10Use this skill for version bumps, release preparation, changelog or README
11updates, website release sync, screenshots, and multilingual release material.
12
13## Read First
14
151. `AGENTS.md`
162. `spec/releases/release-rules.md`
173. `spec/releases/README.md` and the target version record, when present
184. `package.json`, workspace package manifests, and the newest relevant
19 `CHANGELOG.md` section
20
21Do not treat this skill as a second release-policy source. Stable release
22semantics belong in `spec/releases/release-rules.md`; this skill is the
23execution procedure.
24
25## Establish Scope
26
27Before editing, identify:
28
29- target version and release date
30- stable, prerelease, historical prerelease, or docs-only update
31- affected distributions: desktop, CLI, self-hosted web, worker, mobile
32- whether public copy, in-app copy, screenshots, installers, or signing changed
33
34For non-trivial release work, create or update the matching active change
35before implementation.
36
37## Source And Sync Order
38
391. Update version-bearing manifests for affected distributions, including the
40 root and workspace packages when the monorepo version changes.
412. Update `CHANGELOG.md` and `spec/releases/<version>.md`.
423. Sync repository-facing documentation:
43 - `README.md`
44 - `docs/README.md`
45 - `docs/README.en.md`
46 - `docs/README.zh-TW.md`
47 - `docs/README.ja.md`
48 - `docs/README.de.md`
49 - `docs/README.es.md`
50 - `docs/README.fr.md`
514. Run `pnpm --dir website sync:release` and inspect:
52 - `website/src/generated/release.ts`
53 - `website/src/content/docs/changelog.md`
54 - `website/src/content/docs/introduction.md`
55 - `website/src/content/docs/en/introduction.md`
565. Update non-generated website copy only when the release contract changed:
57 - `website/src/i18n/ui.ts`
58 - `website/src/pages/index.astro`
59 - `website/src/pages/en/index.astro`
606. When desktop user-facing copy changed, synchronize all locale files under
61 `apps/desktop/src/renderer/i18n/locales/`.
627. When visible GUI or feature emphasis changed, inspect and update matching
63 assets under `docs/imgs/` and `website/public/imgs/`.
648. Synchronize durable conclusions into `spec/workflow/*`, `spec/knowledge/*`,
65 `spec/rules/*`, or `spec/adr/*` only when their stable contracts changed.
66
67## Release Semantics
68
69- Stable-facing badges, default downloads, and install instructions continue
70 to point to the latest stable version when preparing a prerelease.
71- Historical prereleases below an existing stable version are manual testing
72 artifacts, not the default upgrade path.
73- Do not document a GUI state without matching current UI evidence or updated
74 screenshots.
75- Do not silently skip localized docs or locale files; record why a surface is
76 unaffected.
77- When mentioning CLI availability, distinguish the CLI/npm distribution from
78 desktop-bundled behavior.
79- Use the website sync command instead of hand-editing generated metadata.
80
81## Verification
82
83Run the lowest relevant checks first, then:
84
85- `pnpm verify:release:quick` for local release-impacting changes
86- `pnpm verify:release` before tagging or publishing a release candidate
87- platform signing/notarization checks required by
88 `spec/releases/release-rules.md` for packaged macOS artifacts
89
90Record commands, results, skipped surfaces, and residual risks in the active
91change `implementation.md`. The quick profile is diagnostic and does not grant
92release approval.
93
94## Completion Report
95
96Report:
97
98- target version and release type
99- affected distributions and manifests
100- website sync status
101- screenshot status
102- updated docs and locales
103- verification results
104- intentionally skipped surfaces and remaining release risk