Index of every page on this site: llms.txt
All skills
samanhappy avatar

/polish-release

@874b72a
by Samansamanhappy/mcphub2.7k stars
375
Run it yourself

Polish an existing GitHub release's body into the project's bilingual (English + Chinese) template format with a References section built from merged PRs. Use when 修改 release、整理发布说明、release notes、编辑 release 内容、发版后整理、polish release、edit release body.

  • 1 file
  • 3.5 KB
  • Updated 2 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/samanhappy/mcphub/polish-release

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈78 tokens for metadata: the name and description. ≈813 when used: this file.

Description uses 3.3% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈266 characters, or 3.3%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Polish Release

Rewrite an existing GitHub release's body into the project's bilingual template, then push it back. The repo's release pipeline auto-generates a raw body on tag push (generate_release_notes: true) that does not match the bilingual template — this skill cleans it up.

Structure contract

The required structure lives in exactly one place: .github/release-notes-template.md (read it). It is enforced by scripts/validate-release-notes.js (CI runs it on publish/edit). The rules:

  • Section order must match the template.
  • Summary, 摘要, References must be present and non-empty.
  • Each optional English section (Features/Fixes) and its Chinese pair must appear together — never one without the other.
  • Optional sections with no content are omitted entirely — never an empty section, never None/无 placeholders.
  • References bullets use the exact format <title> by @<login> in <pull url>, followed by one Full changelog: line.
  • New Contributors bullets use @<login> made their first contribution in #<number>.

Workflow

  1. Resolve the target release. Use the tag the user gave (e.g. v1.0.14), else the latest: gh release list --limit 1.

  2. Generate the deterministic parts.

    node scripts/build-release-notes.js <tag>

    This resolves the previous tag (compare line in the existing body, else git describe), fetches merged PRs in the range, and prints a draft skeleton to stdout with <<FILL: ...>> markers where you must write content. It reuses the existing body's ## New Contributors when present and falls back to detecting new contributors itself. It never writes files.

  3. Write the draft in the conversation (not in the working tree). From the PR list in the skeleton:

    • ## Summary — one English paragraph on why this release matters.
    • ## 摘要 — Chinese translation of the Summary.
    • ## Features/## 功能 — user-facing additions (omit if none).
    • ## Fixes/## 修复 — bug fixes, reliability, dependency bumps (omit if none).
    • Translate each bullet into Chinese: PR title in Chinese, then by @<author> and URL as-is.
    • Keep ## New Contributors and ## References as printed, replacing every <<FILL: ...>> marker. Drop any section whose content is empty.
  4. Validate locally before pushing. Write the finished draft to a throwaway temp file (e.g. /tmp/release-notes-<tag>.md, never inside the repo), then:

    node scripts/validate-release-notes.js /tmp/release-notes-<tag>.md

    On failure: report which section is missing/empty/asymmetric/out-of-order/malformed, fix the draft, re-validate.

  5. Push directly (no confirmation round).

    gh release edit <tag> --notes-file /tmp/release-notes-<tag>.md
  6. Clean up. Delete the temp file.

Notes

  • Editing a release is externally visible and re-triggers the release: edited GitHub event (which runs the validator in CI). Always validate locally first.
  • The temp file is only for validation input — keep iteration in the conversation.
  • If the existing body already partially follows the template (e.g. a prior run already edited it), reuse the good parts rather than regenerating from scratch.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 874b72a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago

README badge

README badge for samanhappy/mcphub