Agent skill

Migration Completeness

by diyanbogdanov in diyanbogdanov/emend

What a dependency migration must do before it is finished, regardless of how good the code is.

MITAuto-check passedDevelopment

Install Migration Completeness

skills CLI
$ npx skills add diyanbogdanov/emend --skill migration-completeness -a claude-code

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

GitHub CLI
$ gh skill install diyanbogdanov/emend migration-completeness --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/diyanbogdanov/emend.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/migration-completeness .claude/skills/migration-completeness && 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
migration-completeness
GitHub stars
58
Token cost
~542 tokens
SKILL.md length
330 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

What a dependency migration must do before it is finished, regardless of how good the code is.

  • Works in 5 steps: Finish the migration first. If you are… → Correct every comment the migration… → Behaviour must not change. The one… → …
  • Tasks that involve Code migrations
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Dependency management

What it does

Migration Completeness is an agent skill from diyanbogdanov/emend. What a dependency migration must do before it is finished, regardless of how good the code is. Always applied; the quality skill composes on top.

Its SKILL.md is about 540 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 Code migrations and Dependency management. It works with npm, OpenAPI and TypeScript. The repository describes itself as: Verified AI dependency migrations. Finds which of your lines a version bump actually breaks, fixes them, and proves the result still compiles and passes your tests. The licence is MIT.

When your agent uses it

  • Tasks that involve Code migrations
  • Tasks that involve Dependency management

Example prompts

  • “/migration-completeness”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Finish the migration first. If you are told a deprecated symbol is still
  2. Correct every comment the migration falsified. A comment naming the old
  3. Behaviour must not change. The one exception is rule 1: replacing a
  4. **When a coercion has to stand in for missing data, prefer a value the caller
  5. If the migration is already complete and good, change nothing and say why.

What it can do on your machine

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

    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

Migration Completeness loads about 542 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 330 words of instructions outside code blocks.

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

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 diyanbogdanov/emend at commit f8b72b0, republished under its MIT licence (© diyanbogdanov). 330 words, ~542 tokens.

Download SKILL.mdSave it as .claude/skills/migration-completeness/SKILL.md (or your agent's skills folder).
name
migration-completeness
description
What a dependency migration must do before it is finished, regardless of how good the code is. Always applied; the quality skill composes on top.

Migration Completeness

You are reviewing a dependency migration that already compiles and passes its tests. Passing is the floor, not the goal.

This skill is about whether the migration is finished. A separate quality skill judges whether the result is good. Both apply, and this one outranks it: a beautifully restructured migration that still uses the deprecated API has not done what it said.

Rules

  1. Finish the migration first. If you are told a deprecated symbol is still in use, replacing it is the highest-priority edit in this pass. A migration that reports "X is deprecated", titles its commit after X, and ships with X still in the code has not done what it said. Use the package's supported replacement; if there is genuinely none, leave it and say so.

  2. Correct every comment the migration falsified. A comment naming the old version, or describing behaviour the change altered, is now wrong, and a migration that leaves a false comment behind has not finished. Rewrite it to describe what the code does now, in a form that reads correctly on its own — do not repeat a sentence that already appears beside it, and do not leave a fragment of the old one.

    A comment the migration did not falsify stays exactly as it is.

  3. Behaviour must not change. The one exception is rule 1: replacing a deprecated API with its supported equivalent is the migration finishing its job, not a behaviour change.

  4. When a coercion has to stand in for missing data, prefer a value the caller can detect over one it cannot. Number(x ?? 0) renders a real string as "0", which no test objects to and no reader spots; returning null, or a sentinel the formatter understands, keeps the absence visible.

  5. If the migration is already complete and good, change nothing and say why. That is a valid and useful answer. A pass that invents work to look busy is worse than one that declines.

© diyanbogdanov, 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 skills/migration-completeness of diyanbogdanov/emend.

Open the folder on GitHubat commit f8b72b0

Compare with similar skills

Migration Completeness 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.

Migration Completeness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Migration Completeness this skilldiyanbogdanov/emend58—~542Automated safety check: PassMIT
Migrate to Denodenoland/skills100—~2.2kAutomated safety check: WarnMIT
Linea Dependency MaintenanceConsensys-Incorporated/linea-attestation-registry1771 repos~3.7kAutomated safety check: WarnMIT
Dependabot Alerts Updatelivesession/xyd114—~2kAutomated safety check: PassMIT
Deno Runtime and Package Managerdenoland/skills100—~2.7kAutomated safety check: PassMIT
Monorepo Tooling and Dependenciespierrecomputer/pierre6.3k—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Migrate to Deno

    denoland/skills

    Official

    Moves a Node.js, npm, Yarn, pnpm or Bun project to Deno in reversible steps, starting with Deno as the package manager and changing no code unless needed.

    100 GitHub stars~2.2k tokensUpdated 2 mo ago
    DevelopmentAuto-check: warnings
  • Linea Dependency Maintenance

    Consensys-Incorporated/linea-attestation-registry

    Safely plan and execute dependency maintenance for JavaScript/TypeScript (npm, pnpm) and GitHub Actions, including npm lockfiles, pnpm workspaces, catalogs, overrides, SHA-pinned action versions…

    177 GitHub starsUsed in 1 repo~3.7k tokens
    DevelopmentAuto-check: warnings
  • Automatically fetch and fix Dependabot security alerts by querying GitHub REST API for open alerts, identifying vulnerable packages, researching secure versions, and updating package.json files…

    114 GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Official

    Guides writing, running and configuring Deno 2.9+ projects: installing npm and JSR dependencies, permissions, config file precedence and the built-in fmt, lint, test and compile toolchain.

    100 GitHub stars~2.7k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Sets one monorepo's rules for toolchain pins, pnpm package operations, the shared dependency catalog and moon tasks, so the agent adds versions and scripts the right way.

    6.3k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Fix Security PR

    unional/typescript-blackbook

    Fix a PR that is failing due to security or vulnerability issues — npm/pnpm/yarn/bun audit failures, CVE alerts, Dependabot merge conflicts, Snyk failures, or GitHub security advisory blocks.

    133 GitHub stars~1.4k tokensUpdated 2 days ago
    DevelopmentAuto-check: warnings

More from diyanbogdanov/emend

  • An extremely strict maintainability review for abstraction quality, giant files, and spaghetti-condition growth.

    58 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Migration Completeness

What does Migration Completeness do?

What a dependency migration must do before it is finished, regardless of how good the code is. Migration Completeness is an agent skill from diyanbogdanov/emend. What a dependency migration must do before it is finished, regardless of how good the code is.

When should I use Migration Completeness?

Migration Completeness fits situations like: tasks that involve Code migrations; tasks that involve Dependency management.

How do I install Migration Completeness in Claude Code?

Run `npx skills add diyanbogdanov/emend --skill migration-completeness -a claude-code`. Or copy the skill folder (skills/migration-completeness in diyanbogdanov/emend) into .claude/skills/migration-completeness in your project. Claude Code loads it when a task matches its description.

How do I install Migration Completeness in Codex?

Run `npx skills add diyanbogdanov/emend --skill migration-completeness -a codex`. Or copy the skill folder (skills/migration-completeness in diyanbogdanov/emend) into .agents/skills/migration-completeness in your project. Codex loads it when a task matches its description.

Can I use Migration Completeness 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 diyanbogdanov/emend --skill migration-completeness -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/migration-completeness, .gemini/skills/migration-completeness, .github/skills/migration-completeness and .opencode/skills/migration-completeness in your project.

What does Migration Completeness need to run?

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

Does Migration Completeness 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 Migration Completeness 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 Migration Completeness use?

Migration Completeness 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 Migration Completeness use?

About 542 tokens (SKILL.md is roughly 2.2k 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 Migration Completeness?

Skills that share tags, products or a category with Migration Completeness: Migrate to Deno (denoland/skills, 100 stars), Linea Dependency Maintenance (Consensys-Incorporated/linea-attestation-registry, 177 stars), Dependabot Alerts Update (livesession/xyd, 114 stars) and Deno Runtime and Package Manager (denoland/skills, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Migration Completeness?

diyanbogdanov (a GitHub user) maintains it in diyanbogdanov/emend, which has 58 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 8, 2026.

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