Skip to content

Codex skips 8 skills due to unquoted YAML descriptions in generated SKILL.mdΒ #1800

@GilbertzzzZZ

Description

@GilbertzzzZZ

Hi @garrytan πŸ‘‹

First β€” thank you for building gstack. It's been a huge help for my team, and I genuinely appreciate the work that goes into maintaining it.

Flagging a small Codex compatibility bug:

When loading gstack skills in Codex, 8 skills get skipped with:

Skipped loading 8 skill(s) due to invalid SKILL.md files
invalid YAML: mapping values are not allowed in this context

Root cause: scripts/gen-skill-docs.ts writes long description: values inline after catalog trimming, but some descriptions contain : (e.g. Ship workflow: detect + merge base branch...). Without quoting, YAML parses the embedded colon as a mapping delimiter and the frontmatter fails to load.

Claude Code's loader appears more permissive and doesn't trip on this; Codex's stricter parser does.

Fix already ready in #1739 β€” quotes the inline description values in the generator, updates the catalog-trim tests + the claude-ship golden fixture, and regenerates the affected SKILL.md files. Diff is small and isolated (65 / 61 across generator + regenerated artifacts).

Would really appreciate a review when you have a chance πŸ™ Happy to iterate on anything you'd like changed.

β€” Gilbert

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions