Repository navigation
fix(plugin): Quote plugin YAML frontmatter so all skills and commands load in strict hosts - #50
Merged
Conversation
Version 3.1.0 shipped with five of its ten commands and skills unloadable in GitHub Copilot CLI. Nothing was wrong with the content; the frontmatter just leaned on a lenient YAML reader. An unquoted ": " inside a description aborts a strict parse, and an argument-hint starting with "[" is read as a flow sequence, so the host gets a list where it wants a string. Claude Code accepted all of it, which is how the break reached a release unnoticed. Quote description, argument-hint, and version across all ten files, not just the five that failed, so the next edit cannot reintroduce it. The values are untouched: every one parses back byte-identical to what shipped. Add .github/scripts/check-plugin.py and the workflow that runs it, because the quoting is a fix with a short shelf life on its own. The script enforces quoting, which makes a value a string under every YAML implementation whatever it contains, and layers a strict parse on top when PyYAML is installed, the way migrate-apim validate treats jsonschema. It also checks that all five manifests publish the same version and the same file lists, which a bump that misses one would otherwise get wrong silently. Bump to 3.1.1 across those five manifests. Fixes #49 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Paul Yuknewicz (paulyuk)
approved these changes
Nov 16, 2026
Paul Yuknewicz (paulyuk)
left a comment
Member
There was a problem hiding this comment.
I never understood this about quotes in frontmatter.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #49.
The problem
Install the plugin in GitHub Copilot CLI and half of it silently doesn't show up. Version 3.1.0 loads 3 of 4 skills and 2 of 6 commands. The rest fail with errors like
failed to parse YAML frontmatterorargument-hint must be a string.Nothing is wrong with the content of those files. The problem is punctuation in the YAML header at the top of each one.
Why it happens
Two ordinary-looking lines break stricter YAML readers:
Wrapping the value in quotes tells YAML "this is just text, read it literally":
Claude Code's YAML reader is lenient and accepted the unquoted versions, which is why this shipped without anyone noticing. Copilot CLI's is stricter and rejects them.
The fix
1. Added quotes to all ten command and skill files. Only five were actually broken, but the other five are one careless edit away from the same bug — adding a colon to a description would do it. Quoting all of them closes that off.
No wording changed. Every description and hint parses back byte-identical to what shipped, bodies included. The diff is quote characters and nothing else.
2. Added a CI check (
.github/scripts/check-plugin.py+.github/workflows/plugin.yml) so this can't come back. It verifies that:It needs no extra dependencies to run locally. CI installs PyYAML so it can also do the strict parse.
3. Bumped the version to 3.1.1 in all five manifests:
.claude-plugin/plugin.json,.claude-plugin/marketplace.json,.cursor-plugin/plugin.json,.github/plugin/plugin.json, andgemini-extension.json.Why the CI check matters here
PR #38 rewrites all ten of these files, and it still has the bracket problem in three of them. Running the new check against that branch today:
So fixing the files alone would be undone as soon as #38 lands. The CI check is what turns that into a failed build instead of another quietly broken release.
Verification
8cba384, the released commit the issue names: it reports all five failures, at the same line and column numbers the reporter saw in Copilot CLI.commands/aigateway/*.toml) was already quoted correctly and is unaffected.Not verified: the built plugin was not installed in Copilot CLI itself, so the loader behaviour is taken from the issue report. The error positions line up exactly with a strict parser, which is good corroboration.
🤖 Generated with Claude Code