Post

How is everyone managing their agent SKILL.md files? Is it just chaos? Global skills, repo-specific skills, keeping them in sync between machines, figuring out which ones you have installed, authoring new ones. What are we doing?

I think there is a fundamental UX issue with skills.md. skills.md are documentation for AIs and they have all the failure modes of documentation. The fundamental issue is that skills.md try to anticipate the future 'What will some unknown user need to know to accomplish some unknown task".

This is an ill posed problem. A well posed problem is "Tell me what you did to accomplish some task". Every time we turn the crank we should be logging what we did and why. Then we should AI figure out how to generalize from these past examples

But how do you tell the agent which parts to log? That's the skill. Encoding tacit knowledge in skills while the explicit knowledge is just spec files in the repo

I think you want a document centric UX not the conversation centric UX you have today. As you work with the agent you should be producing a doc of the problem describing the problem you are trying to solve and how you solved it