Rules for writing code that coding agents (and humans) can find and understand through plain-text search. Apply whenever writing or renaming code: functions, types, constants, files, error messages, doc comments. Grounded in measurement: agents navigate by plain-text search, not by AST or language server, so every identifier is a search query and every search miss costs wasted reads.
Install
npx skills add modem-dev/skills --skill write-discoverable-codenpx skills add modem-dev/skills --skill write-discoverable-code -a claude-code -gnpx skills add modem-dev/skills --skill write-discoverable-code -a codex -ggemini skills install https://github.com/modem-dev/skills.git --path write-discoverable-codegh skill install modem-dev/skills write-discoverable-codegit clone --depth 1 https://github.com/modem-dev/skills /tmp/modem-dev__skills
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/modem-dev__skills/write-discoverable-code ~/.claude/skills/write-discoverable-code # Claude Code
cp -R /tmp/modem-dev__skills/write-discoverable-code ~/.agents/skills/write-discoverable-code # Codex, Cursor, Gemini CLI, Copilot, OpenCode