mcp-server: Skill for Claude Code

Before doing anything, ask the user three questions in a single prompt:

1. What version are we releasing? (e.g. 1.55.0)
2. MCP only or also agent? — MCP only (v1.55.0) or both MCP and agent (v1.55.0 + agent-v1.55.0)
3. Release mode — tag directly from main or create a release PR first?

Then follow the matching path below.

---

Path A — Tag directly from main

1. Find the base tag

BASE_TAG=$(git tag --list 'v*' | grep -v '\-dev\.' | grep -v 'agent-v' | sort -V | tail -1)

2. Collect merged PRs since that tag

BASE_TIMESTAMP=$(git log -1 --format=%cI $BASE_TAG)
gh api --paginate "repos/keboola/mcp-server/pulls?state=closed&sort=updated&direction=desc&per_page=100" \
  --jq ".[] | select(.merged_at != null and .merged_at > \"${BASE_TIMESTAMP}\") | {number, title, user: .user.login, merged_at}"

3. Categorise — include: breaking changes, new features, enhancements, bug fixes. Skip: CI/internal, docs-only, dependency bumps, integtest changes.

4. Present the draft release notes to the user in this format — plain prose only, no PR numbers or links:

Release vX.Y.Z — changes since vA.B.C:

#### ⚠️ Breaking Changes
- **Title**: What changed and what users must do to migrate.

#### New Features
- **Title**: What it does and what problem it solves.

#### Enhancements
- **Title**: What improved and the observable effect.

#### Bug Fixes
- **Title**: What was broken and what is now correct.

Omit any section that has no entries.

5. Ask the user: "Ready to push tags?" — wait for explicit confirmation before proceeding.

6. Create and push tags (only after confirmation):

PREV_BRANCH=$(git branch --show-current)
git checkout main && git pull
git tag vX.Y.Z
# if agent release confirmed in step 0:
git tag agent-vX.Y.Z
git push origin vX.Y.Z
# if agent release:
git push origin agent-vX.Y.Z
git checkout "$PREV_BRANCH"

---

Path B — Release PR first, then tag

1–3. Same as Path A steps 1–3 (find base tag, collect PRs, categorise).