agentleFS
bighamxbighamx/openclaw-android-node-apk/.agents/skills/release-openclaw-announcement/SKILL.md

release-openclaw-announcement

Skill59 starsChanged 16 days agoMITView on GitHub

Draft or post OpenClaw beta, stable, or extended-stable Discord release announcements from changelog, tag, registry, and validation evidence. Use when announcing a release, release candidate, or asking what users should test after an OpenClaw release.

  • Installs packages

We split this skill into the rules it gives an agent

14 rules. About 0 are common, 10 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use with release-openclaw-maintainer after a release is live.

    line 8
  2. Very specific:

    Use with $discord-user-post when actually posting to Discord as the logged-in user.

    line 9
  3. Distinctive:

    Before drafting focus areas, read real release evidence:

    line 14
  4. Distinctive:

    Do not claim a full changelog audit unless you did it.

    line 28
  5. Distinctive:

    Do not let late release-branch fixes automatically dominate the announcement.

    line 43
  6. Distinctive:

    If the version includes a large delta from the previous shipped version, rank focus areas by the whole release delta and expected user …

    line 44
  7. Distinctive:

    Every beta announcement must make beta status explicit and include:

    line 50
  8. Distinctive:

    update command promoted near the top:

    line 55
  9. Distinctive:

    Do not suggest npm install commands in beta announcements unless the operator explicitly asks for npm-specific copy or troubleshooting text.

    line 65
  10. Very specific:

    Do not add --yes: users moving from newer regular stable must see the downgrade warning because older versions may not understand newer …

    line 86
  11. Distinctive:

    Keep it skimmable: short intro, bullets, commands, links.

    line 94
  12. Distinctive:

    Do not mention private local proof paths in public announcements.

    line 98
  13. Distinctive:

    Do not overstate unverified platforms, channels, or provider behavior.

    line 99
  14. Very specific:

    When asked to post, use $discord-user-post to operate the logged-in Discord desktop app as the user.

    line 103

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

OpenClaw Release Announcement

Use with release-openclaw-maintainer after a release is live. Use with $discord-user-post when actually posting to Discord as the logged-in user.

Evidence First

Before drafting focus areas, read real release evidence:

  1. GitHub release body and immutable tag; for extended-stable, also confirm the npm/container-only scope and non-Latest classification.
  2. The released base version's CHANGELOG/<version>.md and contribution record, resolved with node scripts/release-changelog.mjs read --version <version> [--ref <sha-or-tag>] (add --record for accounting). The shared resolver reads historical monolithic tags; current CHANGELOG.md is an index. After approved docs publication, read the complete docs mirror and frozen record rather than treating the compact GitHub body as full notes.
  3. Commits since the previous shipped version or the operator-specified base.
  4. Registry/package metadata for the exact version and current dist-tag.
  5. Validation status that is relevant to user confidence.

Do not claim a full changelog audit unless you did it. If you only read the generated release notes or selected changelog section, say that and either audit properly or draft with that limitation.

For beta focus areas, prioritize user-observable changes over internal test or CI mechanics:

  • install/update paths
  • OS/platform-specific behavior
  • Gateway startup/restart, config, and runtime behavior
  • provider/model/runtime routing
  • plugin loading and local plugin development
  • channels and media paths
  • security/data-loss/user-impact fixes

Do not let late release-branch fixes automatically dominate the announcement. If the version includes a large delta from the previous shipped version, rank focus areas by the whole release delta and expected user impact; mention late fixes in their natural category.

Required Copy

Every beta announcement must make beta status explicit and include:

  • exact version, e.g. OpenClaw 2026.5.25-beta.1
  • one-sentence risk framing: beta, useful for testing, not stable promotion
  • focused test areas derived from evidence, not guesswork
  • update command promoted near the top:
    openclaw update --channel beta --yes
    openclaw --version
  • fresh install path: Install from https://openclaw.ai
  • GitHub release link
  • concise validation note, without making CI the headline

Do not suggest npm install commands in beta announcements unless the operator explicitly asks for npm-specific copy or troubleshooting text. It is fine to use registry metadata as evidence; do not turn that into public install guidance.

For stable announcements, use the stable channel wording:

openclaw update --channel stable --yes
openclaw --version

Fresh installs still point to https://openclaw.ai.

For extended-stable, name the exact version and trailing month. Mention only observable backports, and use:

openclaw update --channel extended-stable
openclaw --version

Do not add --yes: users moving from newer regular stable must see the downgrade warning because older versions may not understand newer configuration. Link the GitHub Release, but do not inherit regular stable macOS, Windows, ClawHub, latest, or website claims.

Style

  • Discord Markdown, no tables.
  • Keep it skimmable: short intro, bullets, commands, links.
  • Lead with what users can feel or test, not proof plumbing.
  • Mention validation only after install/update instructions.
  • Be specific about where feedback is useful.
  • Do not mention private local proof paths in public announcements.
  • Do not overstate unverified platforms, channels, or provider behavior.

Posting

When asked to post, use $discord-user-post to operate the logged-in Discord desktop app as the user. Resolve and visibly verify the exact server/channel, inspect the final body, and request action-time confirmation before entering or sending it. Never use OpenClaw channel sends, bots, webhooks, relays, or tokens.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.