Skip to content

fix(openclaw): make native skills codex-friendly#864

Open
cathrynlavery wants to merge 1 commit intogarrytan:mainfrom
cathrynlavery:fix/openclaw-codex-frontmatter
Open

fix(openclaw): make native skills codex-friendly#864
cathrynlavery wants to merge 1 commit intogarrytan:mainfrom
cathrynlavery:fix/openclaw-codex-frontmatter

Conversation

@cathrynlavery
Copy link
Copy Markdown

Summary

This fixes the hand-authored OpenClaw skills so they load cleanly in stricter skill parsers like Codex.

Problem

The native OpenClaw skills under openclaw/skills/ were using frontmatter that included:

  • long unquoted description: scalars containing :
  • extra fields like version and metadata

That works in some environments, but Codex rejects these files with errors like:

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

GitHub also renders the same YAML parsing error on affected files.

Changes

  • normalize the 4 native OpenClaw skills to strict frontmatter with only:
    • name
    • description
  • rewrite descriptions into Use when ... form
  • add a focused test to ensure OpenClaw native skills:
    • parse as YAML
    • keep only name + description

Files changed

  • openclaw/skills/gstack-openclaw-investigate/SKILL.md
  • openclaw/skills/gstack-openclaw-office-hours/SKILL.md
  • openclaw/skills/gstack-openclaw-ceo-review/SKILL.md
  • openclaw/skills/gstack-openclaw-retro/SKILL.md
  • test/openclaw-native-skills.test.ts

Verification

bun test test/openclaw-native-skills.test.ts

Passed locally.

@cathrynlavery cathrynlavery force-pushed the fix/openclaw-codex-frontmatter branch from 212ee0d to c220249 Compare April 6, 2026 16:13
@silverstein
Copy link
Copy Markdown

silverstein commented Apr 6, 2026

Running into the same thing on my end, great fix @cathrynlavery! Please merge 🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants