Skip to content

fix(skills): valid YAML frontmatter for sem-ai-bootstrap (Codex skip)#60

Merged
skipi merged 1 commit into
mainfrom
mk/fix/skill-yaml-frontmatter
Jun 17, 2026
Merged

fix(skills): valid YAML frontmatter for sem-ai-bootstrap (Codex skip)#60
skipi merged 1 commit into
mainfrom
mk/fix/skill-yaml-frontmatter

Conversation

@skipi

@skipi skipi commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

Closes #43.

Codex skipped loading the sem-ai-bootstrap skill with:

invalid YAML: mapping values are not allowed in this context at line 2 column 273

Cause: the description value contains command not found: sem-ai. The unquoted : (colon-space) is parsed as a key: value mapping by strict YAML parsers, so Codex rejects the frontmatter. Claude Code's looser parser accepted it, which hid the bug.

Fix: single-quote the description (with the lone apostrophe in isn't doubled per YAML rules). The rendered string is byte-for-byte unchanged.

Verified with yq: the fixed file parses, the description round-trips exactly, and all 17 bundled SKILL.md frontmatters are now valid YAML (the other 16 already were — they have no colon-space in the value).

🤖 Generated with Claude Code

@github-actions github-actions Bot added the bug Something isn't working label Jun 17, 2026
The description contained `command not found: sem-ai` — an unquoted
colon-space that strict YAML parsers read as a mapping key, so Codex
rejected the file with "mapping values are not allowed in this context"
and skipped loading the skill. Claude Code's parser tolerated it, hiding
the bug. Single-quote the value (apostrophe doubled) so it parses as a
plain string everywhere; the rendered text is unchanged.

The other 16 skills already parse as valid YAML (verified with yq).

Closes #43

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@skipi skipi force-pushed the mk/fix/skill-yaml-frontmatter branch from 4dcd25b to 82a2d99 Compare June 17, 2026 10:59
@skipi skipi merged commit 7fb3d9d into main Jun 17, 2026
1 check passed
@skipi skipi deleted the mk/fix/skill-yaml-frontmatter branch June 17, 2026 11:00
@skipi skipi mentioned this pull request Jun 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

codex skips loading skills due to invalid SKILL.md files

2 participants