Agent skill

Renovate Migrate

by commercetools in commercetools/ui-kit

Perform migrations for Renovate dependency upgrades based on breaking changes identified in a review.

MITAuto-check: notesFrontend & Design

Install Renovate Migrate

skills CLI
$ npx skills add commercetools/ui-kit --skill renovate-migrate -a claude-code

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

GitHub CLI
$ gh skill install commercetools/ui-kit renovate-migrate --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/commercetools/ui-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/renovate-migrate .claude/skills/renovate-migrate && 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
renovate-migrate
GitHub stars
154
Token cost
~1.2k tokens
SKILL.md length
503 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Perform migrations for Renovate dependency upgrades based on breaking changes identified in a review.

  • Works in 7 steps: Load Review Context → Gather Additional PR Context → Perform Migrations → …
  • Tasks that involve Design systems
  • SKILL.md covers Arguments, Prerequisites, Process and Important Notes
  • Calls gh, git and pnpm

What it does

Renovate Migrate is an agent skill from commercetools/ui-kit. Perform migrations for Renovate dependency upgrades based on breaking changes identified in a review. Use after running /renovate-review.

Its SKILL.md is about 1.2k 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 Frontend & Design, covering Design systems. The licence is MIT.

When your agent uses it

  • Tasks that involve Design systems

Example prompts

  • “/renovate-migrate”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Grep, Glob, Read, Edit, Write, WebFetch

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Load Review Context
  2. Gather Additional PR Context
  3. Perform Migrations
  4. Verify Changes
  5. Generate Summary
  6. Push Changes (if --push flag provided)
  7. Post Summary Comment (if --comment flag provided)

What it can do on your machine

Read from SKILL.md and the folder at commit 62ca335. 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:

    • Bash
    • Grep
    • Glob
    • Read
    • Edit
    • Write
    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git
    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use gh, git and pnpm, 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

Renovate Migrate loads about 1.2k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 503 words of instructions outside code blocks.

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

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: Bash, Grep, Glob, Read, Edit, Write, WebFetch

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 commercetools/ui-kit at commit 62ca335, republished under its MIT licence (© commercetools). 503 words, ~1,189 tokens.

Download SKILL.mdSave it as .claude/skills/renovate-migrate/SKILL.md (or your agent's skills folder).
name
renovate-migrate
description
Perform migrations for Renovate dependency upgrades based on breaking changes identified in a review. Use after running /renovate-review.
allowed-tools
Bash, Grep, Glob, Read, Edit, Write, WebFetch
disable-model-invocation
false
argument-hint
[pr-number] [--comment] [--push]
scope
dependencies, migration

Renovate Dependency Migration

Perform code migrations for a Renovate PR based on breaking changes identified during review.

Arguments

  • pr-number (required): The PR number to migrate
  • --comment (optional): Post the migration summary as a PR comment. If omitted, only output the summary locally.
  • --push (optional): Push commits to the remote after completing migrations. If omitted, only commits locally.

Prerequisites

This skill should be run after /renovate-review has identified breaking changes that require code modifications.

Process

1. Load Review Context

First, check if the review information is already available:

Option A: Check conversation context If /renovate-review was run earlier in the same conversation, the review details (breaking changes, affected files, required code changes) should already be in context. Use that information directly.

Option B: Load from GitHub PR comment If not in context, fetch the review comment from the PR:

bash
gh pr view <pr-number> --json comments --jq '.comments[] | select(.body | contains("## Dependency Upgrade Review")) | .body'

From the review comment, extract:

  • Package name and version change
  • Upgrade type (patch/minor/major)
  • Breaking changes that affect this codebase
  • List of affected files and required code changes
2. Gather Additional PR Context
bash
gh pr view <pr-number> --json title,body,files

Use this to supplement the review information if needed (e.g., to get the full list of files changed by Renovate).

3. Perform Migrations

Use the "Required Code Changes" section from the review to guide migrations. For each breaking change:

  1. Reference the review: The review already identified what API changed and how
  2. Find all occurrences: Search for the old API usage (review may have already listed these)
  3. Apply the fix: Update code to use the new API as specified in the review
  4. Commit immediately: Make a small, focused commit
Commit Guidelines
  • Make one commit per logical change (e.g., one commit per breaking change addressed)
  • Keep commits small and focused
  • Use this commit message format:
refactor: migrate <package-name> to v<version> - <specific change>

<brief description of what was changed and why>

Example commit messages:

  • refactor: migrate p-retry to v7 - use named export
  • refactor: migrate lodash to v5 - replace _.pluck with _.map
  • refactor: migrate react-query to v5 - update useQuery options
Show full SKILL.md (188 more words)Show less
Commit Command
bash
git add <specific-files>
git commit -m "refactor: migrate <package> to v<version> - <change>"
4. Verify Changes

After all migrations:

  1. Ensure the code compiles: pnpm run build or pnpm run build:ts
  2. Format the code with Prettier and pnpm run format
  3. Run relevant tests if available
  4. If --push flag is provided, push to remote; otherwise keep changes local
5. Generate Summary

Create a summary of all changes made:

markdown
## Migration Summary: `<package-name>` v<old> → v<new>

**Commits:** <count>
**Files modified:** <count>
**Status:** Build passes / Tests pass / Ready for review

<details>
<summary>Commits</summary>

- `<short-hash>` <commit message>
- ...

</details>

<details>
<summary>Changes</summary>

- `path/to/file1.ts` - <what was changed>
- ...

</details>

Run `git log --oneline -n <count>` to review, then `git push` when ready.
6. Push Changes (if --push flag provided)

Only push to remote if the --push flag was included in the arguments.

If --push is provided:

bash
git push

If --push is NOT provided, skip this step and only keep changes local.

7. Post Summary Comment (if --comment flag provided)

Only post the summary to the PR if the --comment flag was included in the arguments.

If --comment is provided:

bash
gh pr comment <pr-number> --body "<migration-summary>"

If --comment is NOT provided, skip this step and only display the summary locally.

Important Notes

  • Push behavior: Only push to remote if --push flag is provided. Otherwise, only commit locally.
  • Small commits: Each commit should address one specific change.
  • Verify as you go: Run typecheck after each significant change if possible.
  • Preserve behavior: Migrations should not change application behavior, only update API usage.

© commercetools, 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 .agents/skills/renovate-migrate of commercetools/ui-kit.

Open the folder on GitHubat commit 62ca335

Compare with similar skills

Renovate Migrate 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.

Renovate Migrate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Renovate Migrate this skillcommercetools/ui-kit154—~1.2kAutomated safety check: NotesMIT
Scraps Reviewgetsentry/sentry46k—~1.2kAutomated safety check: NotesCustom licence
Architecture Mapalmendili/skills3821 repos~2.3kAutomated safety check: PassNone
Plate UIudecode/plate17k—~2.6kAutomated safety check: PassCustom licence
Fast Agent Designevalstate/fast-agent3.9k—~220Automated safety check: PassApache-2.0
Kaizen UINVIDIA/Personal-AI-Router1.6k—~4.7kAutomated safety check: PassApache-2.0

Similar skills

  • Scraps Review

    getsentry/sentry

    Official

    Filter large Sentry Scraps design-system migration PRs for review by separating mechanical import-path changes, generated baseline updates, snapshot mocks, and pure renames from substantive…

    46k GitHub stars~1.2k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Architecture Map

    almendili/skills

    Build or update an interactive isometric map of a repository's architecture — buildings sized by real measurements, neighborhoods by subsystem, animated flows tracing actual call paths, and a drift…

    382 GitHub starsUsed in 1 repo~2.3k tokens
    Frontend & DesignAuto-check passed
  • Plate UI

    udecode/plate

    Build new shadcn-style components for Plate's registry and editor surfaces.

    17k GitHub stars~2.6k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Fast Agent Design

    evalstate/fast-agent

    A skill your agent uses to generate well-branded interfaces and assets for fast-agent, either for production or throwaway prototypes/mocks/etc.

    3.9k GitHub stars~220 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Kaizen UI

    NVIDIA/Personal-AI-Router

    Official

    Kaizen UI (KUI) component library and design-pattern advisor for NVIDIA applications.

    1.6k GitHub stars~4.7k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Using Docs Kit

    lobehub/lobe-ui

    Set up and author a documentation site with @lobehub/docs-kit (the lobedocs CLI, React Router + Vite static docs used by ui.lobehub.com).

    2.2k GitHub stars~2.8k tokensUpdated today
    Frontend & DesignAuto-check passed

More from commercetools/ui-kit

All 11 skills in this repo
  • Agent Restore Context

    commercetools/ui-kit

    Manage restore context files so skills can survive /clear and /compact.

    154 GitHub stars~944 tokensUpdated 6 days ago
    Auto-check: notes
  • Agent Restore Context Setup

    commercetools/ui-kit

    Set up the restore-context hook so skills can resume workflows after /clear and /compact.

    154 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check: notes
  • PR Review Navigator

    commercetools/ui-kit

    Generate AI-assisted navigation aids to help humans start reviewing a pull request more efficiently.

    154 GitHub stars~1.3k tokensUpdated 6 days ago
    Auto-check: notes
  • Remember

    commercetools/ui-kit

    Persist guidelines, conventions, and architectural decisions into the repository's knowledge base.

    154 GitHub stars~2k tokensUpdated 6 days ago
    Auto-check: notes
  • Renovate Review

    commercetools/ui-kit

    Review Renovate dependency upgrade PRs to assess safety and effort.

    154 GitHub stars~907 tokensUpdated 6 days ago
    Auto-check: notes
  • Repo Healthcheck Node

    commercetools/ui-kit

    Verify a Node.js/TypeScript repo's development environment is correctly set up.

    154 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check: notes

Questions about Renovate Migrate

What does Renovate Migrate do?

Perform migrations for Renovate dependency upgrades based on breaking changes identified in a review. Renovate Migrate is an agent skill from commercetools/ui-kit. Perform migrations for Renovate dependency upgrades based on breaking changes identified in a review.

When should I use Renovate Migrate?

Renovate Migrate fits situations like: tasks that involve Design systems.

How do I install Renovate Migrate in Claude Code?

Run `npx skills add commercetools/ui-kit --skill renovate-migrate -a claude-code`. Or copy the skill folder (.agents/skills/renovate-migrate in commercetools/ui-kit) into .claude/skills/renovate-migrate in your project. Claude Code loads it when a task matches its description.

How do I install Renovate Migrate in Codex?

Run `npx skills add commercetools/ui-kit --skill renovate-migrate -a codex`. Or copy the skill folder (.agents/skills/renovate-migrate in commercetools/ui-kit) into .agents/skills/renovate-migrate in your project. Codex loads it when a task matches its description.

Can I use Renovate Migrate 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 commercetools/ui-kit --skill renovate-migrate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/renovate-migrate, .gemini/skills/renovate-migrate, .github/skills/renovate-migrate and .opencode/skills/renovate-migrate in your project.

What does Renovate Migrate need to run?

Going by SKILL.md and its folder, Renovate Migrate needs the command-line tools its instructions call (gh, git and pnpm). Its frontmatter pre-approves these tools: Bash, Grep, Glob, Read, Edit, Write, WebFetch.

Does Renovate Migrate access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Renovate Migrate 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 Renovate Migrate use?

Renovate Migrate 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 Renovate Migrate use?

About 1.2k tokens (SKILL.md is roughly 4.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 Renovate Migrate?

Skills that share tags, products or a category with Renovate Migrate: Scraps Review (getsentry/sentry, 46k stars), Architecture Map (almendili/skills, 382 stars), Plate UI (udecode/plate, 17k stars) and Fast Agent Design (evalstate/fast-agent, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Renovate Migrate?

commercetools (a GitHub organization) maintains it in commercetools/ui-kit, which has 154 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 3, 2026.

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