Heya #TechnicalWriting hive mind - I am curious for your thoughts!
I've been thinking a lot lately about the intersection of docs, AI skills, and custom agents as it relates to content reuse.
The name of the game in AI-assisted anything these days is context management. You don't want to blow up your context with an overly-verbose documentation page - or Skill file - and let's not even talk about handing an LLM an entire section of your docs.
I've been pondering how we can make our content more modular to enable just-in-time context discovery for LLMs. Sure seems to me like a new take on an old trick - DITA - but I'm not seeing anything like this implemented anywhere yet. Are you aware of any companies that have successfully modularized their docs content to support reuse in different AI contexts?
I've tried things like Skill Seekers to create Skills from docs content, but the verbosity is an issue. We really need much smaller chunks to right-size content to fit into a context window without overwhelming it, while human readers may have different preferences (fewer clicks, larger pages).
If you know of any company that is successfully doing something like this right now, please share!
Links from the comments: