Explains how a subsystem, feature flow, or runtime path works (architecture, data flow, file map, gotchas), with an optional critique by fresh-context critics. Read-only. Use when asked how a subsystem or flow works or where logic belongs. Not for why code is shaped as it is; use investigating-design-rationale. Not for explaining a PR or diff; use explaining-code.
Install
npx skills add bostonaholic/skills --skill explaining-architecturenpx skills add bostonaholic/skills --skill explaining-architecture -a claude-code -gnpx skills add bostonaholic/skills --skill explaining-architecture -a codex -ggemini skills install https://github.com/bostonaholic/skills.git --path skills/engineering/explaining-architecturegh skill install bostonaholic/skills explaining-architecturegit clone --depth 1 https://github.com/bostonaholic/skills /tmp/bostonaholic__skills
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/bostonaholic__skills/skills/engineering/explaining-architecture ~/.claude/skills/explaining-architecture # Claude Code
cp -R /tmp/bostonaholic__skills/skills/engineering/explaining-architecture ~/.agents/skills/explaining-architecture # Codex, Cursor, Gemini CLI, Copilot, OpenCode