Symlink-Based Single Source of Truth Architecture
The system's core design philosophy is 'store once, link everywhere.' All SKILL.md files are stored in a unified ~/.agents/skills/ directory as the immutable authoritative source. For each detected AI agent tool, the application creates an OS-level symlink within that tool's designated config directory, pointing back to the central store. The technical advantage of this design is significant: when you edit a file in the central directory, all linked agent paths instantly read the new content. The synchronization is handled entirely by the OS kernel, requiring no background services or network requests, and works flawlessly in offline environments.
