Codex's quick_validate.py allows only name, description, license,
allowed-tools and metadata at the top level, and rejects < or > in a
description. 77 SKILL.md files carried version/author/tags/
compatible_tools (and similar) at the top level and 36 descriptions
contained angle brackets, so they failed on a clean Codex install.
- Move those keys under metadata: (values verified identical after the
move; claude-coach's duplicate Name/Version keys dropped).
- Reword angle brackets in descriptions (/cs:x <arg> -> /cs:x [arg],
-> -> arrow, >50% -> more than 50%, and so on).
- check_frontmatter.py now fails a SKILL.md that reintroduces either.
Claude Code runtime keys (context, argument-hint) stay top-level: they
change behaviour, so they are left for Codex to ignore.
Closes#1027
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01H62X35SkaV44z2QQZQGqnC