Skip to content
Kitbay
Skillprovisional

deprecate-feature

NOASSERTIONUpdated on Nov 11, 2026105,390GitHub stars

A contributor skill in the PyTorch repository for retiring APIs under the project's backward-compatibility policy.

What the skill teaches

A contributor skill in the PyTorch repository for retiring APIs under the project's backward-compatibility policy. It covers deprecating or freezing an API, with the warning wording, a warn-once pattern, docstring notes, tests and labels; tracking each item as a GitHub issue attached to PyTorch's parent deprecation tracker, asking the user before any issue is edited; and removing code once the required number of releases with a warning has passed, or auditing targets that are overdue. It reads the current version from version.txt and gives a gh api command for linking sub-issues and a git grep command for finding removal targets. The skill calls itself provisional.

Capabilities

  • Add deprecation warnings and docstring notes
  • Track deprecations as GitHub sub-issues
  • Find APIs that are due for removal
  • Remove deprecated code after the warning period