Agent skill

Semver Analyzer

by revfactory in revfactory/harness-100

시맨틱 버저닝(SemVer) 규칙에 따라 변경사항을 분석하고 적절한 버전 번호를 결정하는 방법론. An agent skill from revfactory/harness-100.

Apache-2.0Auto-check passedDevelopment

Install Semver Analyzer

skills CLI
$ npx skills add revfactory/harness-100 --skill semver-analyzer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install revfactory/harness-100 semver-analyzer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ko/39-changelog-generator/.claude/skills/semver-analyzer .claude/skills/semver-analyzer && rm -rf skills-src

Use ~/.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/

Facts

Skill name
semver-analyzer
GitHub stars
1.3k
Token cost
~688 tokens
SKILL.md length
226 words
Files
1
Skills in repo
464
Repo updated
First seen
Licence
Apache-2.0

At a glance

시맨틱 버저닝(SemVer) 규칙에 따라 변경사항을 분석하고 적절한 버전 번호를 결정하는 방법론. An agent skill from revfactory/harness-100.

  • Tasks that involve CI/CD
  • SKILL.md covers 대상 에이전트, SemVer 2.0.0 핵심 규칙, Breaking Change 판정 매트릭스 and 버전 범프 결정 알고리즘, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Changelog and release notes

What it does

Semver Analyzer is an agent skill from revfactory/harness-100. 시맨틱 버저닝(SemVer) 규칙에 따라 변경사항을 분석하고 적절한 버전 번호를 결정하는 방법론. 'SemVer 분석', '버전 번호 결정', 'Breaking Change 판정', '버전 범프 결정' 등 버전 관리 시 사용한다. 단, git 태그 자동 생성, CI/CD 릴리스 실행은 이 스킬의 범위가 아니다.

Its SKILL.md is about 690 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 CI/CD and Changelog and release notes. It works with Git. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve CI/CD
  • Tasks that involve Changelog and release notes

Example prompts

  • “SemVer 분석”
  • “Breaking Change 판정”
  • “/semver-analyzer”

What it can do on your machine

Read from SKILL.md and the folder at commit 8e8d35c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Semver Analyzer loads about 688 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 226 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~688

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 passed

The automated check found no risky patterns in SKILL.md.

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 revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 226 words, ~688 tokens.

Download SKILL.mdSave it as .claude/skills/semver-analyzer/SKILL.md (or your agent's skills folder).
name
semver-analyzer
description
시맨틱 버저닝(SemVer) 규칙에 따라 변경사항을 분석하고 적절한 버전 번호를 결정하는 방법론. 'SemVer 분석', '버전 번호 결정', 'Breaking Change 판정', '버전 범프 결정' 등 버전 관리 시 사용한다. 단, git 태그 자동 생성, CI/CD 릴리스 실행은 이 스킬의 범위가 아니다.

SemVer Analyzer — 시맨틱 버저닝 분석 방법론

change-classifier와 release-note-writer의 버전 결정 역량을 강화하는 스킬.

대상 에이전트

  • change-classifier — 변경사항의 SemVer 영향도를 판정한다
  • release-note-writer — 버전 번호와 하이라이트를 결정한다

SemVer 2.0.0 핵심 규칙

MAJOR.MINOR.PATCH[-prerelease][+build]

MAJOR: 호환되지 않는 API 변경 (Breaking Change)
MINOR: 하위 호환 기능 추가
PATCH: 하위 호환 버그 수정

Breaking Change 판정 매트릭스

API/라이브러리
변경 유형Breaking?예시
공개 함수 삭제YESremove_user() 삭제
공개 함수 시그니처 변경YES필수 매개변수 추가/제거
반환 타입 변경YESdict → list
예외 타입 변경YESValueError → TypeError
기본값 변경MAYBE동작 변경 여부에 따라
새 선택 매개변수 추가NOdef func(x, new=None)
새 공개 함수 추가NO기존 코드 영향 없음
내부 함수 변경NO_private_func()
성능 개선NO동작 동일
웹 API (REST/GraphQL)
변경 유형Breaking?
엔드포인트 삭제/이동YES
필수 필드 추가 (요청)YES
응답 필드 삭제YES
응답 구조 변경YES
인증 방식 변경YES
새 선택 필드 추가 (요청)NO
새 응답 필드 추가NO
새 엔드포인트 추가NO
데이터베이스
변경 유형Breaking?
테이블/컬럼 삭제YES
NOT NULL 제약 추가YES
컬럼 타입 변경YES
새 nullable 컬럼 추가NO
새 인덱스 추가NO

버전 범프 결정 알고리즘

입력: 변경사항 목록

1. Breaking Change 있음? → MAJOR 범프
2. 새 기능 있음? → MINOR 범프
3. 버그 수정만? → PATCH 범프

특수 규칙:
- MAJOR = 0 (개발 중): Breaking Change도 MINOR로 허용
- pre-release 붙은 경우: 0.x.y-alpha.1 → 정식 릴리스 시 MAJOR
- 여러 유형 혼합 시: 가장 높은 수준 적용

Conventional Commits 매핑

접두사SemVer 영향릴리스 노트 섹션
feat:MINORAdded (추가)
fix:PATCHFixed (수정)
feat!: / BREAKING CHANGE:MAJORBreaking Changes
perf:PATCHPerformance (성능)
refactor:-Changed (변경)
docs:-Documentation
test:-- (노트 제외 가능)
chore:-- (노트 제외 가능)
ci:-- (노트 제외 가능)
style:-- (노트 제외 가능)
deps:PATCH~MAJORDependencies

Keep a Changelog 형식

markdown
# Changelog

## [Unreleased]

## [2.0.0] - 2025-01-15

### Breaking Changes
- `createUser()` API가 `registerUser()`로 이름 변경 (#123)

### Added
- 팀 관리 기능 추가 (#456)
- 다크모드 지원 (#789)

### Changed
- 로그인 화면 UI 개선 (#234)

### Deprecated
- `v1` API 엔드포인트 (v3.0에서 제거 예정)

### Fixed
- 비밀번호 재설정 이메일 미발송 문제 (#567)

### Security
- XSS 취약점 패치 (#890)

프리릴리스 버전 체계

1.0.0-alpha.1 → 초기 알파
1.0.0-alpha.2 → 알파 수정
1.0.0-beta.1  → 베타 진입
1.0.0-beta.2  → 베타 수정
1.0.0-rc.1    → 릴리스 후보
1.0.0         → 정식 릴리스

우선순위: alpha < beta < rc < release

© revfactory, Apache-2.0. 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 ko/39-changelog-generator/.claude/skills/semver-analyzer of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Semver Analyzer 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.

Semver Analyzer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Semver Analyzer this skillrevfactory/harness-1001.3k—~688Automated safety check: PassApache-2.0
Worktrunk Release Workflowmax-sixty/worktrunk8.9k—~6.9kAutomated safety check: PassCustom licence
Coffee GB Releasetrekawek/coffee-gb1.2k—~1.4kAutomated safety check: PassMIT
Kt Search Releasejillesvangurp/kt-search155—~1.2kAutomated safety check: PassMIT
Codex Proxy RS Releasezyycn/codex-proxy-rs738—~327Automated safety check: PassApache-2.0
Docs CIjh941213/my-cc-harness126—~989Automated safety check: NotesNone

Similar skills

  • Worktrunk Release Workflow

    max-sixty/worktrunk

    Walks a maintainer through cutting a Worktrunk release: sync the release branch, pass two test gates, review the changes, then publish.

    8.9k GitHub stars~6.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Coffee GB Release

    trekawek/coffee-gb

    Releases the current Coffee GB Maven snapshot through the GitHub Maven release workflow, then verifies and curates the tag and GitHub release.

    1.2k GitHub stars~1.4k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Kt Search Release

    jillesvangurp/kt-search

    A skill your agent uses when the user wants to cut, publish, tag, or create a GitHub release for kt-search, especially when the task includes version bumping, validating that commits are pushed…

    155 GitHub stars~1.2k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Codex Proxy RS Release

    zyycn/codex-proxy-rs

    Plans versions, writes release notes, publishes stable or pre-release builds and recovers from failed releases for Codex Proxy RS, without covering deploys or tag cleanup.

    738 GitHub stars~327 tokensUpdated today
    DevelopmentAuto-check passed
  • Docs CI

    jh941213/my-cc-harness

    Scaffold a docs-as-code CI/CD pipeline + docs drift detection — link check, OpenAPI lint/breaking gate, mermaid validation, docs freshness check, CHANGELOG automation, docs.yaml manifest.

    126 GitHub stars~989 tokensUpdated 2 mo ago
    DevelopmentAuto-check: notes
  • Git Changes Reporter

    No-Trade-No-Life/Yuan

    生成结构化 git 变更报告(JSON + Markdown)。使用此技能当用户提到"git 变更"、"commit 摘要"、"代码审查"、"release note"、"近期改动"、"每日摘要",或需要分析指定 commit 区间的代码变更。包含三元组结构(设计意图、核心代码、影响范围)的语义化报告,适用于代码审查、发布说明、团队同步、CI/CD 等场景。

    352 GitHub stars~1.2k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed

More from revfactory/harness-100

All 464 skills in this repo
  • Anti Bot Analyzer

    revfactory/harness-100

    A skill for analyzing website anti-bot defense mechanisms and developing legitimate evasion strategies.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • API Security Checklist

    revfactory/harness-100

    Walks a backend-dev agent through OWASP API Top 10 checks, authentication and authorization patterns, and defense code during API design.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Arg Parser Generator

    revfactory/harness-100

    Methodology for systematically designing and generating CLI tool argument parser structures.

    1.3k GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Audience Segmentation

    revfactory/harness-100

    Audience segmentation skill used by the analyst and curator agents.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Audio Storytelling

    revfactory/harness-100

    Audio storytelling skill used by the podcast scriptwriter and show note editor.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Works with

Questions about Semver Analyzer

What does Semver Analyzer do?

시맨틱 버저닝(SemVer) 규칙에 따라 변경사항을 분석하고 적절한 버전 번호를 결정하는 방법론. An agent skill from revfactory/harness-100. Semver Analyzer is an agent skill from revfactory/harness-100. 시맨틱 버저닝(SemVer) 규칙에 따라 변경사항을 분석하고 적절한 버전 번호를 결정하는 방법론.

When should I use Semver Analyzer?

Semver Analyzer fits situations like: tasks that involve CI/CD; tasks that involve Changelog and release notes.

How do I install Semver Analyzer in Claude Code?

Run `npx skills add revfactory/harness-100 --skill semver-analyzer -a claude-code`. Or copy the skill folder (ko/39-changelog-generator/.claude/skills/semver-analyzer in revfactory/harness-100) into .claude/skills/semver-analyzer in your project. Claude Code loads it when a task matches its description.

How do I install Semver Analyzer in Codex?

Run `npx skills add revfactory/harness-100 --skill semver-analyzer -a codex`. Or copy the skill folder (ko/39-changelog-generator/.claude/skills/semver-analyzer in revfactory/harness-100) into .agents/skills/semver-analyzer in your project. Codex loads it when a task matches its description.

Can I use Semver Analyzer 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 revfactory/harness-100 --skill semver-analyzer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/semver-analyzer, .gemini/skills/semver-analyzer, .github/skills/semver-analyzer and .opencode/skills/semver-analyzer in your project.

What does Semver Analyzer need to run?

SKILL.md names no scripts, command-line tools or credentials: Semver Analyzer is instructions for the agent only.

Does Semver Analyzer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Semver Analyzer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Semver Analyzer use?

Semver Analyzer is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Semver Analyzer use?

About 688 tokens (SKILL.md is roughly 2.8k 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 Semver Analyzer?

Skills that share tags, products or a category with Semver Analyzer: Worktrunk Release Workflow (max-sixty/worktrunk, 8.9k stars), Coffee GB Release (trekawek/coffee-gb, 1.2k stars), Kt Search Release (jillesvangurp/kt-search, 155 stars) and Codex Proxy RS Release (zyycn/codex-proxy-rs, 738 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Semver Analyzer?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,290 GitHub stars. The repository holds 464 skills in this directory. The repository was last updated on March 22, 2026.

Source: revfactory/harness-100 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.