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.
Summary
The official managed Shopify plugin distributed through Codex, version
4.0.1, contains malformed YAML frontmatter inskills/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
mainbranch.Environment
0.153.24.0.1shopify-shopifyqlskill metadata version1.12.2Startup error
Malformed frontmatter in the managed bundle
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:
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.mdfrontmatter during the bundle build. Local cache edits are overwritten by plugin updates, so the workaround is not durable.