If you build with AI agents: is packaging knowledge into reusable skills a real pain, or am I imagining it?

2 months ago
I've been building with AI agents for a while, and the thing that keeps biting me isn't the model — it's that every agent is only as good as the knowledge you hand it. I keep finding myself copying a doc into a chat, reformatting it into steps, adding a "when should you use this," writing a little done-checklist, and then doing that same dance over and over for every new workflow. It's the boring 20 minutes nobody talks about, and it feels like the reason most people's agents stay generic.
Before I build anything heavier around this, I want to sanity-check whether the pain is actually real for other people or just my own workflow being messy.
So, if you build with agents: how are you handling reusable knowledge today — hand-writing skill files, ignoring it entirely, or using some tool I don't know about? How much time does it actually eat? And if something could turn a raw doc or SOP into a clean, structured, agent-ready skill in a few seconds, would you trust auto-generated output enough to run it, or would that always need a human pass first?
Genuinely trying to figure out if this is a problem worth solving. Tear it apart.


You're not imagining it, but "it bugs me" and "enough people pay to make it a product" are different bars, and the gap is where a lot of agent tooling dies.
Cheapest check before you build: go where agent builders vent, LangChain/LlamaIndex GitHub issues, r/LocalLLaMA, the framework Discords; and count how many describe the exact ritual you just did (copy a doc in, reformat into steps, add "when to use this").
If the same hand-rolled workaround keeps showing up from different people, the pain is real and structural, not just your setup.
If it's mostly you, it's probably a workflow tweak, not a product. Repetition across different builders is the signal I'd trust over my own frustration.