Skip to content

fix(skills): quote agent-orchestration description to fix invalid YAML frontmatter#139

Merged
codeaholicguy merged 1 commit into
mainfrom
fix/issue-138-yaml-frontmatter
Jul 26, 2026
Merged

fix(skills): quote agent-orchestration description to fix invalid YAML frontmatter#139
codeaholicguy merged 1 commit into
mainfrom
fix/issue-138-yaml-frontmatter

Conversation

@codeaholicguy

Copy link
Copy Markdown
Owner

Summary

  • skills/agent-orchestration/SKILL.md had an unquoted colon inside its frontmatter description value, which YAML interprets as a nested mapping key and breaks parsing (e.g. via gray-matter, used by the CLI's skill index).
  • Fix: wrap the description value in double quotes. No other content changed.

Closes #138

Validation

  • claude plugin validate .✔ Validation passed
  • python3 -c "yaml.safe_load(...)" on the frontmatter: failed before with mapping values are not allowed here (line 3, col 78); succeeds after.
  • node -e "gray-matter(...)" (actual parser used by packages/cli/src/util/skill.ts) now correctly extracts name and description.
  • Swept all skills/*/SKILL.md files through gray-matter — all parse cleanly with name/description present.
  • npx vitest run src/__tests__/lib/SkillManager.test.ts (packages/cli) → 60/60 passed.
  • Full repo validation before commit: npm run build (6 projects), nx run-many -t lint (0 errors), nx run-many -t test → 901/901 tests passed across all packages (via pre-commit hook).

Test plan

  • claude plugin validate .
  • SkillManager.test.ts suite
  • Full monorepo lint + test via pre-commit hook

…L frontmatter

The description contained an unquoted colon, which YAML parses as a nested
mapping key and breaks frontmatter parsing (e.g. gray-matter used by the
CLI's skill index).

Fixes #138
@codeaholicguy
codeaholicguy merged commit 15b09d2 into main Jul 26, 2026
7 checks passed
@codeaholicguy
codeaholicguy deleted the fix/issue-138-yaml-frontmatter branch July 26, 2026 04:57
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.

Directory review: one skill has broken YAML frontmatter (fails plugin validation)

1 participant