shubhamtaywade82/node-agent-skills/node-api-contract-migration

Claude Code and agent skill by shubhamtaywade82/node-agent-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when a breaking or semantic API change requires coordinated migration.

Install

npx vskill@latest install shubhamtaywade82/node-agent-skills/node-api-contract-migration

SKILL.md

The same SKILL.md was published earlier as shubhamtaywade82/node-agent-skills/node-api-contract-migration.

API Contract Migration

Purpose

planning and executing versioned API contract changes across producers and consumers.

Activate when

  • a breaking or semantic API change requires coordinated migration.
  • The behavior crosses a public, persistence, messaging, security, or runtime boundary.

Repository inspection

  1. Detect Node.js/TypeScript version, package manager, framework, and relevant infrastructure.
  2. Locate the authoritative contract and all direct consumers.
  3. Inspect tests, schemas, migrations, queues, configuration, and CI.
  4. Confirm exact dependency versions before using adapter-specific APIs.

Decision rules

migrations need an overlap period when consumers cannot change atomically; old and new contracts have explicit ownership and retirement criteria

  • Treat external/runtime data as untrusted until validated.
  • Preserve existing invariants unless the task explicitly changes them.
  • Prefer bounded, observable, idempotent operations.
  • Keep security and authorization decisions at authoritative boundaries.

Implementation procedure

  1. Inventory consumers.
  2. Define target contract.
  3. Add compatibility layer.
  4. Migrate consumers.
  5. Measure old usage.
  6. Announce deprecation.
  7. Remove only after exit criteria.

Failure modes

Avoid:

  • flag-day migrations across independent consumers; compatibility shim without retirement plan.
  • Silent compatibility, consistency, or security changes.
  • Unbounded work, retries, storage, or fan-out.

Verification

  1. Write contract/regression coverage before behavior changes.
  2. Exercise malformed input, duplicate/replay, migration, and recovery paths where applicable.
  3. Run focused tests and the full repository suite.
  4. Run typecheck/build/lint/package validation as supported.
  5. Inspect the final diff for unintended contract or dependency changes.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/shubhamtaywade82/node-agent-skills/node-api-contract-migration/badge)](https://verified-skill.com/skills/shubhamtaywade82/node-agent-skills/node-api-contract-migration)

Something wrong with this skill or its page? Tell us.