Skip to content

Quote agent descriptions that strict YAML parsers reject - #337

Merged
necatiozmen merged 1 commit into
VoltAgent:mainfrom
xubenqiang:fix/quote-colon-space-descriptions
Oct 30, 2026
Merged

necatiozmen merged 1 commit into
VoltAgent:mainfrom
xubenqiang:fix/quote-colon-space-descriptions

Conversation

@xubenqiang

Copy link
Copy Markdown
Contributor

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 with mapping 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.md
  • categories/07-specialized-domains/hipaa-compliance.md
  • categories/08-business-product/assumption-mapping.md
  • categories/08-business-product/backlog-grooming.md
  • categories/08-business-product/growth-loops.md
  • categories/08-business-product/telegram-ads-analyst.md
  • categories/10-research-analysis/ab-test-analysis.md
  • categories/10-research-analysis/cohort-analysis.md
  • categories/10-research-analysis/first-principles-thinking.md

Per CONTRIBUTING, the four affected category plugin versions are bumped and .claude-plugin/marketplace.json follows: voltagent-qa-sec 1.1.2 -> 1.1.3, voltagent-domains 1.0.4 -> 1.0.5, voltagent-biz 1.0.5 -> 1.0.6, voltagent-research 1.0.4 -> 1.0.5.

How I checked it

Parsing every frontmatter block under categories/ with PyYAML before the change reported 9 failures, all mapping values are not allowed here; after the change the same scan reports:

scanned 163 agent files, invalid frontmatter: 0

Two further checks, both passing:

  • for each changed file the parsed description string is identical to the previous raw value, so only the YAML representation changed;
  • every plugin.json version equals its marketplace.json entry, and every changed category has a version different from main (what .github/workflows/enforce-plugin-version-bump.yml checks).

AI assistance

This change was prepared with an AI coding agent (DeepSeek Harness / deepseek-flash) and verified with the checks above.

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
Copilot AI balanced review requested due to automatic review settings October 28, 2026 16:55

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@necatiozmen
necatiozmen merged commit f2e2ea7 into VoltAgent:main Oct 30, 2026
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.

9 agent descriptions are unquoted and contain a colon-space (invalid YAML)

3 participants