Claude Code and Codex skills are directories, not files

Why Claude Code and Codex discover agent skills as a directory containing SKILL.md, not a flat markdown file, and what silently breaks when an installer gets that wrong.

September 20, 2026 · 4 min · Russell