tool-rename-deprecation

Preserve renamed tool references in legacy arrays for backward compatibility.

5|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/malwarebo/nyrve --skill tool-rename-deprecation-malwarebo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-rename-deprecation
Source: https://github.com/malwarebo/nyrve/tree/main/.github/skills/tool-rename-deprecation
Command: npx skills add https://github.com/malwarebo/nyrve --skill tool-rename-deprecation-malwarebo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that when tool or tool set reference names are changed, backward compatibility is maintained by preserving old names as legacy entries, preventing breakage in existing configurations and prompts.

Core Features & Use Cases

  • Preserves Backward Compatibility: Automatically adds old tool/tool set names to legacy arrays upon renaming.
  • Catches Regressions: Identifies dropped legacy names during code reviews or direct modifications.
  • Use Case: When renaming a tool from oldName to newName, this skill guides you to add oldName to legacyToolReferenceFullNames, ensuring any prompts or configurations still referencing oldName continue to function.

Quick Start

Run this skill whenever a tool's toolReferenceName or a tool set's referenceName is changed to ensure the old name is added to the appropriate legacy array.

Frequently Asked Questions about tool-rename-deprecation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain backward compatibility when renaming tools in TypeScript?

To maintain backward compatibility when renaming tools in TypeScript, add the old tool identifier to the `legacyToolReferenceFullNames` array. This ensures existing prompts and configurations referencing the old name continue to resolve correctly.

What happens to prompt file resolution if I change a tool reference name without keeping legacy names?

If you change a tool reference name without keeping legacy names, prompt file resolution, tool enablement, and auto-approval configurations will break. Existing setups referencing the old identifier will fail to locate the renamed tool.

Do I need to update package.json contributions when renaming a tool set?

Yes, when renaming a tool set you need to update package.json contributions. You must add the old reference name to the `legacyFullNames` array to preserve backward compatibility for external configurations and registrations.

What is the best way to catch dropped legacy tool names during code maintenance?

The best way to catch dropped legacy tool names during code maintenance is to run a deprecation check. This identifies missing old names in legacy arrays during direct modifications or code reviews, preventing regressions.

When do I need to use legacy arrays for tool renames?

You need to use legacy arrays for tool renames whenever a `toolReferenceName` or tool set `referenceName` is modified. This preserves the old identifiers so backward compatibility is maintained across internal and external registrations.