Module skill_shadow 

Live-skill shadow detector and reporting for Codex.

Codex discovers skills from repository-ancestor .agents/skills directories, the user’s ~/.agents/skills, /etc/codex/skills, and enabled installed plugins. A logical eval skill present in any of those sources contaminates the control arm even when eval-magic stages its test copy under a generated name. Detection is deliberately best-effort: unreadable/malformed skills and an unavailable or invalid plugin listing are ignored, while all other sources continue to be scanned.

Functions

format_shadow_banner

Codex-specific build-time banner. Empty when nothing is shadowed.

shadow_preflight

Detect logical eval skill names that Codex can also load from live sources.

shadow_validity_warnings

One Codex-specific validity_warnings line per shadowed skill.