Module skill_shadow 

Harness-neutral skill-shadow report types and formatters.

A shadow is a staged skill name that is also discoverable from the operator’s live environment, contaminating the with/without comparison. Detection is harness-specific (each adapter’s detect_shadowed_skills decides what “discoverable” means); the report shape and its renderings are shared. The remediation text is Claude-flavored because only the Claude Code adapter produces reports today — promote the formatters to adapter methods when a second harness wires this preflight.

Structs

PluginShadowReport

The detector’s findings for a run.

Enums

ShadowSource

A staged skill that is also discoverable from the live environment.

Functions

format_shadow_banner

Build-time banner for the runner. Empty string when nothing is shadowed.

shadow_validity_warnings

One validity_warnings line per shadowed skill (for benchmark.json).