tool-rename-deprecation

Validate renamed tool references preserve backward compatibility via legacy arrays.

189k|41.5k|Updated Sep 3, 2015
One-click install
npx skills add https://github.com/microsoft/vscode --skill tool-rename-deprecation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-rename-deprecation
Source: https://github.com/microsoft/vscode/tree/main/.github/skills/tool-rename-deprecation
Command: npx skills add https://github.com/microsoft/vscode --skill tool-rename-deprecation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents breaking existing functionality by ensuring that when tool or tool set reference names are changed, the old names are preserved as legacy aliases, maintaining backward compatibility for prompt files, configurations, and saved references.

Core Features & Use Cases

  • Backward Compatibility: Guarantees that tools and tool sets remain accessible even after their names are updated.
  • Regression Prevention: Catches errors where legacy references are dropped during renaming operations.
  • Use Case: After renaming a tool from oldName to newName, this skill ensures that any existing prompts or configurations that still refer to oldName continue to function correctly by mapping them to newName.

Quick Start

Run this skill whenever a tool or tool set reference name is changed to verify legacy 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 maintain backward compatibility when renaming tool references?

To maintain backward compatibility when renaming tool references, add the old names to legacy arrays like legacyToolReferenceFullNames and legacyFullNames so existing prompts and configurations continue functioning.

Why do my prompt files break after a tool rename refactoring?

Prompt files break after tool renaming if old references are not added to legacy arrays, which this process validates by checking prompt files, tool configurations, and auto-approval settings to ensure deprecated names are honored.

How do I deprecate a tool name without breaking existing configurations?

To deprecate a tool name without breaking configurations, map the old name as a legacy alias to the new name, ensuring that auto-approval settings and tool registrations preserve access to the deprecated references.

Can I check if tool set renaming preserves legacy references automatically?

Yes, you can verify tool set renaming preserves legacy references by validating that old names are added to the legacyFullNames array and checking that all prompt files and tool configurations honor these deprecated names.

What happens if legacy references are dropped during a tool renaming operation?

If legacy references are dropped during tool renaming, existing prompts and saved configurations will fail, making regression prevention critical to ensure old names are mapped correctly to the new tool names.

When do I need to run backward compatibility validation for deprecated tools?

You need to run backward compatibility validation for deprecated tools whenever a built-in tool or tool set reference name is changed, ensuring all prompt files, configurations, and auto-approval settings honor the old names.