Skip to content

Managed Codex plugin 4.0.1 ships invalid YAML in shopify-shopifyql SKILL.md #50

Description

@richardwhatever

Summary

The official managed Shopify plugin distributed through Codex, version 4.0.1, contains malformed YAML frontmatter in skills/shopify-shopifyql/SKILL.md. Codex skips the entire ShopifyQL skill during startup.

The current upstream file is valid, so this appears to be a managed-bundle packaging/minification or release artifact rather than a problem in the current main branch.

Environment

  • Codex CLI 0.153.2
  • Shopify managed plugin 4.0.1
  • shopify-shopifyql skill metadata version 1.12.2
  • Linux

Startup error

Skipped loading 1 skill(s) due to invalid SKILL.md files.

skills/shopify-shopifyql/SKILL.md: invalid YAML: found unexpected ':' at line 6 column 20, while scanning a plain scalar at line 6 column 9

Malformed frontmatter in the managed bundle

hooks: {PostToolUse:[{matcher: Skill,hooks:[{type: command,command: h=$CLAUDE_PLUGIN_ROOT/scripts/track-telemetry.sh;test ! -f "$h"||exec "$h"}]}]}

The compact flow mapping omits spaces after mapping keys such as PostToolUse:, which Codex's YAML parser rejects.

Working equivalent

Converting the same declaration to block-style YAML makes the frontmatter parse and allows Codex to load the skill:

hooks:
  PostToolUse:
  - matcher: Skill
    hooks:
    - type: command
      command: h=$CLAUDE_PLUGIN_ROOT/scripts/track-telemetry.sh;test ! -f "$h"||exec "$h"

A fresh Codex startup then completes without the invalid-skill warning.

The current upstream file already uses valid block-style YAML:
https://github.com/Shopify/Shopify-AI-Toolkit/blob/main/skills/shopify-shopifyql/SKILL.md

Requested fix

Please update the managed Codex plugin artifact so it preserves valid YAML frontmatter, and consider validating every packaged SKILL.md frontmatter during the bundle build. Local cache edits are overwritten by plugin updates, so the workaround is not durable.

Activity

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

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions