This repository uses AGENTS.md as the canonical cross-tool instruction file and adds thin wrappers for popular agentic tools.
| Tool | File added | Notes |
|---|---|---|
| Codex and AGENTS-compatible agents | AGENTS.md |
Canonical instructions |
| Claude Code | CLAUDE.md |
Short wrapper that points to AGENTS.md |
| Gemini CLI | GEMINI.md |
Short wrapper that points to AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
Repository-wide Copilot instructions |
| GitHub Copilot path rules | .github/instructions/uxl-skills.instructions.md |
Applies to catalog files |
| Cursor | .cursor/rules/uxl-skills.mdc |
Project rule |
| Continue | .continue/rules/uxl-skills.md |
Workspace rule |
| Aider | CONVENTIONS.md, .aider.conf.yml |
Conventions loaded read-only by config |
| Windsurf | .windsurfrules |
Project rules |
| Cline | .clinerules/uxl-skills.md |
Project rules |
| Devin-style autonomous agents | DEVIN.md |
Human-readable repo notes; AGENTS.md remains primary |
| OpenHands-style agents | .agents/skills/uxl-skills-catalog.md |
Optional repository skill wrapper |
Keep wrappers short. Update AGENTS.md first, then mirror only essential changes into tool-specific files.
The wrapper files are generated by:
python scripts/generate_agent_wrappers.pyCI checks drift with:
python scripts/generate_agent_wrappers.py --checkCI also validates the agent configuration surface with agent-sh/agnix:
npx agnix@0.36.0 .The GitHub Action uses .agnix.toml and pins agnix to v0.36.0.