Skip to content

fix(skills): quote argument-hint values so YAML parses them as strings#507

Open
fhirt wants to merge 2 commits into
Egonex-AI:mainfrom
fhirt:fix/skill-argument-hint-yaml-string
Open

fix(skills): quote argument-hint values so YAML parses them as strings#507
fhirt wants to merge 2 commits into
Egonex-AI:mainfrom
fhirt:fix/skill-argument-hint-yaml-string

Conversation

@fhirt

@fhirt fhirt commented Jun 24, 2026

Copy link
Copy Markdown

Summary

Fixes #506.

Six skills fail to load with argument-hint must be a string because the argument-hint values use bare YAML bracket syntax which YAML parses as arrays instead of strings.

Changes

2 commits:

  1. fix(skills) — Quote all argument-hint values in the 6 affected SKILL.md files so YAML treats them as strings:
File Before After
understand/SKILL.md ["[path] [--full|...]"] "[path] [--full|...]"
understand-chat/SKILL.md [query] "[query]"
understand-dashboard/SKILL.md [project-path] "[project-path]"
understand-domain/SKILL.md [--full] "[--full]"
understand-explain/SKILL.md [file-path] "[file-path]"
understand-knowledge/SKILL.md [wiki-directory] "[wiki-directory]"

Skills without argument-hint (understand-diff, understand-onboard) are unaffected and already load correctly.

  1. chore — Bump version 2.8.1 → 2.8.2 across all 5 version files per CLAUDE.md convention.

PR Checklist

  • Commit messages follow convention (fix: / chore:)
  • Branch name follows convention (fix/skill-argument-hint-yaml-string)
  • PR description explains what changed and why
  • Linked to issue bug: 6 skills fail to load — argument-hint must be a string (YAML bracket syntax parsed as array) #506
  • Version bumped in all 5 files (2.8.1 → 2.8.2)
  • Tests/lint: this change is pure YAML frontmatter in SKILL.md files — no TypeScript code was modified. ESLint and Vitest only cover .ts/.tsx files; neither will flag this change. CI will confirm.
  • No debug code, no console.log
  • Branch is up to date with main

fhirt added 2 commits June 24, 2026 09:52
Bare bracket syntax like `argument-hint: [query]` is parsed by YAML as
an array. The Copilot CLI skill loader requires argument-hint to be a
string, causing 6 skills to fail to load with:

  argument-hint must be a string

Fix: wrap each value in double-quotes so YAML treats it as a string.
For understand/SKILL.md the value was already a string inside an array;
remove the outer brackets.

Fixes Egonex-AI#506
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.

bug: 6 skills fail to load — argument-hint must be a string (YAML bracket syntax parsed as array)

1 participant