Agent skill · software engineering · jimliu
release-skills
Universal release workflow. Auto-detects version files and changelogs. Supports Node.js, Python, Rust, Claude Plugin, GitHub Releases, annotated tags, historical release backfill, and generic projects. Use when user says "release", "发布", "new version", "bump version", "push", "推送", "release notes", "GitHub Release", or "回填 Release".
Why this skill is useful
Adds a comprehensive executable release workflow that automates version detection and changelog management across multiple programming languages.
What it needs
Requires gh installed locally. About 11k tokens when loaded. Last updated 2026-07-04. 24,677 stars on the source repository.
What this skill does
Release Skills Universal release workflow supporting any project type with multi-language changelog. User Input Tools When this skill prompts the user, follow this tool-selection rule (priority order): 1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, requestuserinput, clarify, askuser, or any equivalent. 2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question. 3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order. Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes. Quick Start Just run /release-skills - auto-detects your project configuration. Supported Projects Project Type Version File Auto-Detected -------------- -------------- --------------- Node.js package.json ✓ Python pyproject.toml ✓ Rust Cargo.toml ✓ Claude Plugin marketplace.json ✓ Generic VERSION / version.txt ✓ Options Flag Description ------ ------------- --dry-run Preview changes without executing --major Force major version bump --minor Force minor version bump --patch Force patch version bump --backfill-releases Create missing GitHub Releases for existing tags from changelog sections Workflow Step 1: Detect Project Configuration 1. Check for .releaserc.yml (optional config override) If present, inspect whether it defines release hooks 2. Auto-detect version file by scanning (priority order): package.json (Node.js) pyproject.toml (Python) Cargo.toml (Rust) marketplace.json or .claude-plugin/marketplace.json (Claude Plugin) VERSION or version.txt (Generic) 3. Scan for changelog files using glob patterns: CHANGELOG.md HISTORY.md CHANGES.md 4. Identify language of each changelog by filename suffix 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jimliu/release-skills--061f19