skills/AGENTS.md

Agent Instructions

Platform-agnostic development

Everything in this repository MUST work on every agent runtime, not only on the one developing it: Claude Code, Codex, Gemini CLI, Hermes, OpenClaw and any other that reads skills. The same holds for operating systems and distributions.

• Logic in scripts: behaviour lives in python3 or bash scripts that any runtime can call. Hooks, plugins and settings of one runtime are thin adapters over those scripts, never the only path to a feature.
• Skills stay portable: a SKILL.md that uses a runtime-specific tool (AskUserQuestion, SendMessage, a slash command) says what the step needs, so another runtime can use its own equivalent.
• Installs reach every runtime: install into the cross-runtime locations (~/.agents/skills) or through an installer that configures every detected agent; runtime-specific locations are mirrors. Of a tool that ships both, take the agent-agnostic integration over one runtime's plugin, and never both: the same server would run twice.
• No single package manager: an install never depends on one OS or distribution's package manager; prefer upstream or statically linked release builds.
• One instruction file: rules live here and nowhere else; no CLAUDE.md, CLAUDE.local.md or GEMINI.md. Claude Code reads this file natively from v2.1.277; Gemini CLI once its context.fileName setting lists AGENTS.md.

Code questions

Ask the codebase-memory-mcp graph first (search_graph, trace_path, get_architecture); grep only after it.