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-migrationSKILL.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
- Detect Node.js/TypeScript version, package manager, framework, and relevant infrastructure.
- Locate the authoritative contract and all direct consumers.
- Inspect tests, schemas, migrations, queues, configuration, and CI.
- 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
- Inventory consumers.
- Define target contract.
- Add compatibility layer.
- Migrate consumers.
- Measure old usage.
- Announce deprecation.
- 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
- Write contract/regression coverage before behavior changes.
- Exercise malformed input, duplicate/replay, migration, and recovery paths where applicable.
- Run focused tests and the full repository suite.
- Run typecheck/build/lint/package validation as supported.
- 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
- SKILL.md in the repositoryCheckingskills/node-api-contract-migration/SKILL.md
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
[](https://verified-skill.com/skills/shubhamtaywade82/node-agent-skills/node-api-contract-migration)