write-discoverable-code
100 / 100 · Low risk
Fine to try.
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.
What this skill can do
We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.
Install
Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.
if [ -e ~/.agents/skills/'write-discoverable-code' ] || [ -L ~/.agents/skills/'write-discoverable-code' ]; then echo 'A skill folder named write-discoverable-code already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/dmmulroy/.dotfiles' "$d" && git -C "$d" checkout --quiet '56e9c3f08663f3a51ff106d0253b2099a3c4feb5' -- 'home/.agents/skills/write-discoverable-code' && mkdir -p ~/.agents/skills && cp -R "$d"/'home/.agents/skills/write-discoverable-code' ~/.agents/skills/'write-discoverable-code' && rm -rf "$d"; fi
Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'write-discoverable-code' ~/.claude/skills/'write-discoverable-code' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.
Badge for your README
[](https://zalavijaysinh.github.io/skilltrust/repos/dmmulroy/.dotfiles/)
Score history
| Date | Version | Score |
|---|---|---|
| 2026-11-09 | 56e9c3f | 100 |
Also found in
- modem-dev/skills/write-discoverable-code