$ loading_
Assess release bump, clean changelog, update versions, and open a release PR.
Copy the install command and let the AI configure it · recommended for beginners
Please install the "cut-release" skill from askskill: 1. Download https://raw.githubusercontent.com/microsoft/apm/main/.apm/skills/cut-release/SKILL.md 2. Save it as ~/.claude/skills/cut-release/SKILL.md 3. Reload skills and tell me it's ready
Cut an APM release from the current worktree: decide whether changes since the last tag require a patch or minor bump, clean up the [Unreleased] changelog section, update pyproject.toml and uv.lock, run the lint/CI checks, and open the release PR; do not create a tag.
A recommended version bump, cleaned release notes, updated version files and checks, plus a review-ready release PR.
Review merged changes since the last tag and determine whether this should be a patch or minor release under semver, explaining why; if it looks like a major release, stop and wait for my confirmation.
A clear recommendation for patch or minor with rationale; if major is needed, the flow stops for explicit approval.
Help with release prep: convert [Unreleased] into a dated version block, keep one concise user-facing note per merged PR, remove internal-only noise and duplicates, then update the version files and open the release PR.
You get concise publishable release notes, synchronized version files, and an opened release PR.
This skill drives the release-cut workflow end-to-end on the current worktree. It STOPS at "PR open"; tagging is the human-gated trigger that fires the release workflow.
Trigger this skill on any of these intents:
Do NOT trigger on:
The skill DEPENDS on these existing primitives in the same source tree. Do not duplicate their content; reference them.
.apm/skills/apm-strategy/SKILL.md -- versioning judgement and
breaking-change lens. Auto-loads via its own trigger on
CHANGELOG.md and release-pipeline edits. Treat it as the
authoritative lens for "is this BREAKING" and "does this
positioning change warrant a migration note"..apm/instructions/linting.instructions.md -- canonical
CI-mirror lint chain. Reference; do not re-derive ruff / pylint
command lists in this skill..github/instructions/changelog.instructions.md -- Keep-a-
Changelog format contract. Reference; do not redefine the
format.Per .github/instructions/encoding.instructions.md, source files in
this bundle (SKILL.md, assets, scripts) MUST stay in printable ASCII.
The PR body and changelog entries this skill produces are also
written to repo files (CHANGELOG.md, PR body), so they MUST stay
ASCII too. Use -- for em dashes, [!] / [+] / [x] for status
markers, and so on.
Run these phases in order. Reload plan.md (the session memento)
at the start of each phase and after every tool return.
git rev-parse --abbrev-ref HEAD.
The skill assumes you are on a release-prep branch (or are
willing to create one). If you are on main, STOP and ask the
operator to put you on a branch.git describe --tags --abbrev=0.<last-tag>..HEAD.Run scripts/list-changes-since-tag.sh (no arguments). It emits
JSON on stdout: one object per merged PR with fields pr, title,
labels, author, paths_summary, is_user_facing_guess.
The script's heuristic for is_user_facing_guess is
intentionally conservative -- it flags as INTERNAL only when the
diff is fully contained in .apm/, .github/instructions/,
tests/, docs/, or matches chore(repo). Treat the field as a
HINT, not a verdict; the LLM makes the final call per
assets/entry-sanitizer.md.
DO NOT rely on training-recalled PR titles. Truth #5: pretraining is frozen. Every PR title in the changelog must come from the script's stdout.
Load assets/semver-rubric.md. Walk every PR from Phase 1
against the rubric. The rubric outputs PATCH, MINOR, or
ESCALATE-TO-MAJOR.
Show the operator:
If the rubric outputs ESCALATE-TO-MAJOR (>= 1.0.0), STOP and
surface the escalation per assets/semver-rubric.md "Major bump"
section. Do not bump to 1.0.0 without explicit operator
confirmation.
Wait for the operator's confirm before continuing.
…
Guide APM positioning, release communication, and breaking-change strategy decisions.
Audit an entire docs corpus against code and propose precise fixes.
Improve CLI output, logs, errors, and terminal diagnostic user experience.
Triages bug batches and drives related PRs to a mergeable state.
Plan doc TOC changes and outline stubs when PRs require structural updates.
Triage APM issues in batches and drive approved ones to mergeable PRs.
Write complete, evidence-backed PR descriptions for microsoft/apm pull requests.
Assess PR documentation impact and produce actionable update guidance every time.
Generate clear user-facing changelogs and release notes from Git commit history.
Helps teams handle APM positioning, release communication, and breaking-change decisions.
Create reusable SKILL.md skills that package repeatable workflows for future use.
Create, refine, validate, and restructure AgentSkills and SKILL.md files.