When something surprising breaks, write one short note — symptom, cause, fix, how to check — named after the symptom, in the shared gotchas folder, so the next session finds it before repeating the mistake.
Install
npx skills add gaurav8936/oneroof --skill capture-gotchasnpx skills add gaurav8936/oneroof --skill capture-gotchas -a claude-code -gnpx skills add gaurav8936/oneroof --skill capture-gotchas -a codex -ggemini skills install https://github.com/gaurav8936/oneroof.git --path agentic_engineering/skills/learn/capture-gotchasgh skill install gaurav8936/oneroof capture-gotchasgit clone --depth 1 https://github.com/gaurav8936/oneroof /tmp/gaurav8936__oneroof
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/gaurav8936__oneroof/agentic_engineering/skills/learn/capture-gotchas ~/.claude/skills/capture-gotchas # Claude Code
cp -R /tmp/gaurav8936__oneroof/agentic_engineering/skills/learn/capture-gotchas ~/.agents/skills/capture-gotchas # Codex, Cursor, Gemini CLI, Copilot, OpenCode