tool-rename-deprecation

Preserve backward compatibility for renamed tools via legacy name mappings.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/DevFlex-AI/devonz-editor-web --skill tool-rename-deprecation-devflex-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-rename-deprecation
Source: https://github.com/DevFlex-AI/devonz-editor-web/tree/main/.github/skills/tool-rename-deprecation
Command: npx skills add https://github.com/DevFlex-AI/devonz-editor-web --skill tool-rename-deprecation-devflex-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Renaming a tool or tool set can break existing prompts, configurations, and activation events. This skill ensures the old names are preserved via legacy mappings so all references keep working.

Core Features & Use Cases

  • Legacy name preservation: Adds old tool references to legacy arrays so prompts, tool enablement, and auto-approval continue to resolve correctly.
  • Cross-context coverage: Applies to internal tools, tool sets, and extension-contributed tools; ensures consistent lookups across prompts and configurations.

Quick Start

Identify the renamed tool or tool set and add the previous name to the appropriate legacy array to maintain compatibility.

Frequently Asked Questions about tool-rename-deprecation

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

FAQPage Schema
How do I keep prompts and configurations working after renaming a tool?

To keep prompts working after renaming a tool, you must add the old tool references to legacy mapping arrays. This preserves backward compatibility by ensuring old names remain resolvable across tool enablement and auto-approval logic.

Why does renaming a toolset break existing prompt resolution and tool activation?

Renaming a toolset breaks prompt resolution and activation because existing configurations and events still reference the old names. Without maintaining legacy name mappings, the system cannot resolve the previous identifiers.

Do I need to update legacy tool references for extension-provided tools?

Yes, you need to update legacy tool references for extension-provided tools. Maintaining legacy name mappings applies to both internal TypeScript tools and extension tools to ensure consistent lookups across all configurations.

What is the best way to maintain backward compatibility for renamed tool references?

The best way to maintain backward compatibility is enforcing the use of legacyToolReferenceFullNames and legacyFullNames arrays. This updates prompt resolution, tool enablement, and auto-approval logic across all consumers automatically.

How do I add old tool names to legacy arrays during tool registration changes?

To add old tool names during registration changes, identify the renamed tool or tool set and insert the previous name into the appropriate legacy array. This maintains compatibility so all old references keep functioning correctly.

What happens if I don't use legacy full name arrays when renaming tools?

Without using legacy full name arrays when renaming tools, old references in prompts and configurations become unresolvable. This breaks tool enablement, auto-approval logic, and activation events across all system consumers.