Agent skills work... sometimes - depends on the agent's mood really.
I tried to solve this in a rather opposite way.
https://github.com/computerreinvention/trie
The documentation is updated and recording the intent behind all changes is enforced by a commit-gate. At the symbol level.