Repository navigation
Quote agent descriptions that strict YAML parsers reject - #337
Merged
necatiozmen merged 1 commit intoOct 30, 2026
Merged
Conversation
Nine agent files have an unquoted description containing ': ', which a plain YAML scalar cannot hold. Claude Code on Windows (CRLF checkout) then fails to parse the frontmatter and loads the agent without its description and tools list. Quote those values the way the other agents already do, and bump the four affected plugin versions so installed copies pick the fix up. Fixes VoltAgent#334
There was a problem hiding this comment.
Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.
An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.
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 #334
What changed
Nine agent files declare
description:as a plain YAML scalar that contains:(... Triggers on: 'GDPR', ...). A plain scalar cannot contain:, so a strict YAML parser rejects the frontmatter withmapping values are not allowed here. Claude Code's lenient retry quotes the value on LF checkouts, which is why this only shows up on Windows, but the files are invalid YAML either way.The nine values are now quoted, the same way the other agents in this repo quote theirs:
categories/04-quality-security/gdpr-ccpa-compliance.mdcategories/07-specialized-domains/hipaa-compliance.mdcategories/08-business-product/assumption-mapping.mdcategories/08-business-product/backlog-grooming.mdcategories/08-business-product/growth-loops.mdcategories/08-business-product/telegram-ads-analyst.mdcategories/10-research-analysis/ab-test-analysis.mdcategories/10-research-analysis/cohort-analysis.mdcategories/10-research-analysis/first-principles-thinking.mdPer CONTRIBUTING, the four affected category plugin versions are bumped and
.claude-plugin/marketplace.jsonfollows:voltagent-qa-sec1.1.2 -> 1.1.3,voltagent-domains1.0.4 -> 1.0.5,voltagent-biz1.0.5 -> 1.0.6,voltagent-research1.0.4 -> 1.0.5.How I checked it
Parsing every frontmatter block under
categories/with PyYAML before the change reported 9 failures, allmapping values are not allowed here; after the change the same scan reports:Two further checks, both passing:
descriptionstring is identical to the previous raw value, so only the YAML representation changed;plugin.jsonversion equals itsmarketplace.jsonentry, and every changed category has a version different frommain(what.github/workflows/enforce-plugin-version-bump.ymlchecks).AI assistance
This change was prepared with an AI coding agent (DeepSeek Harness / deepseek-flash) and verified with the checks above.