The framing in TFA is a dangerous way to think. Codemods are whatever, I could take em or leave em.

What you want isn't skill files for LLMs, though. Just write docs for humans. Write a migration guide, for humans.

It's going to take us a while to realize they should be the same things, skill files and docs.