Agent Workspace Compatibility
- Inspect the canonical skills directory, provider package outputs, instruction aliases, and the build/check commands before making changes.
- Keep one authored skill tree under
.agents/skills/. Provider packages that disallow external symlinks must be generated as physical copies. - Make
AGENTS.mdthe canonical always-on instruction file. Create only relative aliases for provider-specific filenames; never overwrite a real instruction file without explicit approval. - Make the build deterministic and add a check mode that detects generated output drift. Test clean setup, stale output, incorrect links, and repeated runs.
- Use skills.sh for cross-agent installation and its copy mode where symlinks are unavailable.
Next steps: After a migration or audit, use drift-check to verify the
generated package, instructions, and documentation still agree.