tool-rename-deprecation

SKILL.md

Tool Rename Deprecation

When a tool or tool set reference name is changed, the old name must always be added to the deprecated/legacy array so that existing prompt files, tool configurations, and saved references continue to resolve correctly.

When to Use

Run this skill on any change to built-in tool or tool set registration code to catch regressions:

Renaming a tool's toolReferenceName

Renaming a tool set's referenceName

Moving a tool from one tool set to another (the old toolSet/toolName path becomes a legacy name)

Reviewing a PR that modifies tool registration — verify no legacy names were dropped

Procedure

Step 1 — Identify What Changed

Determine whether you are renaming a tool or a tool set, and where it is registered: