ZCF Release Automation
UfoMiao/zcf
Automates a version release with changesets: analyzes code changes, writes a bilingual CHANGELOG, bumps the version and commits through a release branch and pull request.
Automates versioning and release notes generation for hwp2md.
Install Release
$ npx skills add roboco-io/hwp2md --skill release -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install roboco-io/hwp2md release --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/roboco-io/hwp2md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/release .claude/skills/release && 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 "release" agent skill from https://github.com/roboco-io/hwp2md/tree/main/.claude/skills/release into .claude/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", 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/roboco-io/hwp2md/tree/main/.claude/skills/releaseType 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 roboco-io/hwp2md --skill release -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install roboco-io/hwp2md release --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/roboco-io/hwp2md.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/release .agents/skills/release && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "release" agent skill from https://github.com/roboco-io/hwp2md/tree/main/.claude/skills/release into .agents/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", 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 roboco-io/hwp2md --skill release -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install roboco-io/hwp2md release --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/roboco-io/hwp2md.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/release .cursor/skills/release && 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 "release" agent skill from https://github.com/roboco-io/hwp2md/tree/main/.claude/skills/release into .cursor/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", 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/roboco-io/hwp2md.git --path .claude/skills/release--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 roboco-io/hwp2md --skill release -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install roboco-io/hwp2md release --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/roboco-io/hwp2md.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/release .gemini/skills/release && 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 "release" agent skill from https://github.com/roboco-io/hwp2md/tree/main/.claude/skills/release into .gemini/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", 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 roboco-io/hwp2md releaseInstalls 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 roboco-io/hwp2md --skill release -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/roboco-io/hwp2md.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/release .github/skills/release && 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 "release" agent skill from https://github.com/roboco-io/hwp2md/tree/main/.claude/skills/release into .github/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", 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 roboco-io/hwp2md --skill release -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install roboco-io/hwp2md release --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/roboco-io/hwp2md.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/release .opencode/skills/release && 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 "release" agent skill from https://github.com/roboco-io/hwp2md/tree/main/.claude/skills/release into .opencode/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", 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
release- GitHub stars
- 119
- Token cost
- ~774 tokens
- SKILL.md length
- 241 words
- Files
- 1
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
Automates versioning and release notes generation for hwp2md.
- Works in 4 steps: 버전 결정 → 변경사항 분석 → 릴리즈 태그 생성 → …
- Preparing a new release
- SKILL.md covers 사용법, 릴리즈 프로세스, 릴리즈 체크리스트 and 예시: 전체 릴리즈 워크플로우, plus 2 more sections
- Calls git and make
What it does
Release is an agent skill from roboco-io/hwp2md. Automates versioning and release notes generation for hwp2md. Use this skill when preparing a new release, creating version tags, or generating changelogs from git history.
Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Changelog and release notes and Git workflow. It works with GitHub Actions. The repository describes itself as: HWP(한글 워드프로세서) 문서를 Markdown으로 변환하는 도구. The licence is MIT.
When your agent uses it
- Preparing a new release
- Creating version tags
- Generating changelogs from git history
Example prompts
- “Use the release skill to automate versioning and release notes generation for hwp2md”
- “/release”
Requirements
- Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Grep, Glob
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 57c3545. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadWriteEditBashGrepGlob
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
gitmake
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
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
Release loads about 774 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 241 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.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
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
The full file from roboco-io/hwp2md at commit 57c3545, republished under its MIT licence (© roboco-io). 241 words, ~774 tokens.
Download SKILL.mdSave it as
.claude/skills/release/SKILL.md (or your agent's skills folder).- name
- release
- description
- Automates versioning and release notes generation for hwp2md. Use this skill when preparing a new release, creating version tags, or generating changelogs from git history.
- allowed-tools
- Read, Write, Edit, Bash, Grep, Glob
- user-invocable
- true
Release Automation Skill
이 스킬은 hwp2md의 버저닝과 릴리즈를 자동화합니다.
사용법
/release [version] [options]예시:
/release- 다음 버전 자동 결정 및 릴리즈 준비/release v0.2.0- 특정 버전으로 릴리즈/release patch- 패치 버전 증가 (v0.1.0 → v0.1.1)/release minor- 마이너 버전 증가 (v0.1.0 → v0.2.0)/release major- 메이저 버전 증가 (v0.1.0 → v1.0.0)
릴리즈 프로세스
1. 버전 결정
현재 태그 확인:
git tag -l 'v*' --sort=-version:refname | head -5버전 형식: vMAJOR.MINOR.PATCH (Semantic Versioning)
버전 증가 기준:
- MAJOR: 하위 호환성이 깨지는 변경
- MINOR: 새로운 기능 추가 (하위 호환)
- PATCH: 버그 수정, 문서 수정
2. 변경사항 분석
마지막 태그 이후 커밋 분석:
# 마지막 태그 찾기
LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
# 커밋 로그 (태그 이후 또는 전체)
if [ -n "$LAST_TAG" ]; then
git log $LAST_TAG..HEAD --oneline
else
git log --oneline
fi3. 릴리즈 태그 생성
# 태그 생성 (annotated tag)
git tag -a v0.2.0 -m "Release v0.2.0
주요 변경사항:
- 기능 1
- 기능 2
- 버그 수정
"
# 원격에 푸시
git push origin v0.2.04. GitHub Release
goreleaser를 사용한 릴리즈:
# 로컬 테스트 (실제 릴리즈 없이)
goreleaser release --snapshot --clean
# 실제 릴리즈 (CI에서 자동 실행)
goreleaser release --clean릴리즈 체크리스트
릴리즈 전 확인사항:
- 모든 테스트 통과 (
make test) - 린트 검사 통과 (
make lint) - README.md 버전 정보 확인
- main 브랜치에 모든 변경사항 병합
- 이전 릴리즈 이후 breaking change 확인
예시: 전체 릴리즈 워크플로우
# 1. 현재 상태 확인
git status
make test
# 2. 마지막 태그 확인
git describe --tags --abbrev=0
# 3. 변경사항 확인
git log $(git describe --tags --abbrev=0)..HEAD --oneline
# 4. 태그 생성 및 푸시
git tag -a v0.2.0 -m "Release v0.2.0"
git push origin main
git push origin v0.2.0
# 5. GitHub Actions가 자동으로 goreleaser 실행GitHub Actions 자동 릴리즈
태그를 푸시하면 GitHub Actions가 자동으로 릴리즈를 생성합니다.
워크플로우 (.github/workflows/release.yml)
v*태그 푸시 시 트리거- goreleaser가 자동 실행
- 크로스 플랫폼 바이너리 빌드 (Linux, macOS, Windows)
- GitHub Release 페이지에 자동 게시
- 릴리즈 노트 자동 생성 (커밋 메시지 기반)
릴리즈 노트 구조
goreleaser가 커밋 메시지를 분석하여 카테고리별로 정리:
- New Features: Add, Implement, Create, feat 접두사
- Bug Fixes: Fix, Resolve, Correct 접두사
- Improvements: Update, Change, Refactor, Improve 접두사
- Documentation: docs 접두사
릴리즈 실행 방법
# 1. 태그 생성
git tag -a v0.2.0 -m "Release v0.2.0"
# 2. main과 태그 푸시
git push origin main
git push origin v0.2.0
# 3. GitHub Actions가 자동으로:
# - 바이너리 빌드
# - 릴리즈 페이지 생성
# - 릴리즈 노트 생성릴리즈 페이지 내용
자동 생성되는 릴리즈 페이지:
- 설치 방법 (바이너리 다운로드, go install)
- 주요 기능 소개
- 변경 내역 (커밋 기반)
- 전체 변경 로그 링크
- 플랫폼별 바이너리 다운로드
긴급 패치 릴리즈
핫픽스가 필요한 경우:
# 1. 핫픽스 브랜치 생성
git checkout -b hotfix/v0.1.1 v0.1.0
# 2. 수정 적용
# ... 코드 수정 ...
# 3. 커밋 및 태그
git commit -m "Fix: Critical bug description"
git tag -a v0.1.1 -m "Hotfix release v0.1.1"
# 4. main에 병합 및 푸시
git checkout main
git merge hotfix/v0.1.1
git push origin main
git push origin v0.1.1© roboco-io, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/skills/release of roboco-io/hwp2md.
Open the folder on GitHubat commit 57c3545
Compare with similar skills
Release 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 |
|---|---|---|---|---|---|---|
| Release this skillroboco-io/hwp2md | 119 | — | ~774 | Automated safety check: Notes | MIT | |
| ZCF Release AutomationUfoMiao/zcf | 6.1k | — | ~3.4k | Automated safety check: Pass | MIT | |
| Git WorkflowsTencentCloudBase/CloudBase-AI-Toolkit | 1.1k | — | ~3k | Automated safety check: Pass | MIT | |
| CI Automationjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~1.4k | Automated safety check: Notes | MIT | |
| Release Bumpjamiepine/voicebox | 57k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Git Workflow and Versioningaddyosmani/agent-skills | 103k | 2 repos | ~3.5k | Automated safety check: Notes | MIT |
Similar skills
Git Workflows
TencentCloudBase/CloudBase-AI-Toolkit
Reusable git delivery workflows derived from local slash commands (commit, push, PR, release notes, GitHub Actions failure triage with worktree-based fixes, and isolating your own changes from a…
CI Automation
jeremylongshore/tons-of-skills-marketplace
A skill your agent uses when running GitHub Actions locally, creating task runner recipes, generating changelogs from git history, managing GitHub PRs/issues/releases programmatically, or creating…
Release Bump
jamiepine/voicebox
Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.
Git Workflow and Versioning
addyosmani/agent-skills
Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.
- Official
Go-Redis Release Preparation
redis/go-redis
Prepares a go-redis release locally: picks the next semver, gathers merged PRs, writes the RELEASE-NOTES entry and bumps versions, without publishing.
More from roboco-io/hwp2md
Update Hwpx Differences
roboco-io/hwp2md
Updates the HWPX-Markdown differences documentation when a new conversion issue is found or a new handling method is implemented.
Related
Works with
Categories
Questions about Release
What does Release do?
Automates versioning and release notes generation for hwp2md. Release is an agent skill from roboco-io/hwp2md. Automates versioning and release notes generation for hwp2md.
When should I use Release?
Release fits situations like: preparing a new release; creating version tags; generating changelogs from git history.
How do I install Release in Claude Code?
Run `npx skills add roboco-io/hwp2md --skill release -a claude-code`. Or copy the skill folder (.claude/skills/release in roboco-io/hwp2md) into .claude/skills/release in your project. Claude Code loads it when a task matches its description.
How do I install Release in Codex?
Run `npx skills add roboco-io/hwp2md --skill release -a codex`. Or copy the skill folder (.claude/skills/release in roboco-io/hwp2md) into .agents/skills/release in your project. Codex loads it when a task matches its description.
Can I use Release 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 roboco-io/hwp2md --skill release -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/release, .gemini/skills/release, .github/skills/release and .opencode/skills/release in your project.
What does Release need to run?
Going by SKILL.md and its folder, Release needs the command-line tools its instructions call (git and make). Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Grep, Glob.
Does Release access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Release safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Release use?
Release is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Release use?
About 774 tokens (SKILL.md is roughly 3.1k 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 Release?
Skills that share tags, products or a category with Release: ZCF Release Automation (UfoMiao/zcf, 6.1k stars), Git Workflows (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars), CI Automation (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Release Bump (jamiepine/voicebox, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Release?
roboco-io (a GitHub organization) maintains it in roboco-io/hwp2md, which has 119 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on April 27, 2026.
Source: roboco-io/hwp2md on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.