The agent guide lives in AGENTS.md. It is the single source of
truth for every agent platform (Cursor, Codex CLI, Claude Code, ...). skills/
is the canonical, agent-agnostic location for SKILL.md-format workflow guides.
At session start, read in full:
AGENTS.md— request loop, skill layout, library pointers.- All
SKILL.mdfiles anywhere underskills/. Use a traversal that includes every nested directory even when search tools would normally skip ignored paths, for example:find skills -type f -name SKILL.md -print
- All
*.mdcfiles in.cursor/rules/— repo-wide style and policy rules (C++ / Python codestyle, docs style, extension structure, build instructions, pip packaging, ...). Platform-independent. skills/SKILLS.md— categorized index of all skills with one-line descriptions, read order, pipeline diagrams, and the env-var contract. Use it to route to individual skills on demand.
Skills are authored once under skills/. .claude/skills/ contains symlinks
into skills/ so Claude Code's native skill discovery works without
duplication. .cursor/skills/ is retired.