Skip to content

fix: quote argument-hint YAML values so Copilot CLI ≥1.0.65 loads all skills (closes #662)#663

Open
thejesh23 wants to merge 1 commit into
swt-labs:mainfrom
thejesh23:fix/quote-argument-hint-yaml
Open

fix: quote argument-hint YAML values so Copilot CLI ≥1.0.65 loads all skills (closes #662)#663
thejesh23 wants to merge 1 commit into
swt-labs:mainfrom
thejesh23:fix/quote-argument-hint-yaml

Conversation

@thejesh23

Copy link
Copy Markdown

Closes #662.

Summary

Purely mechanical single-character transform to 9 file(s): wrap the value after argument-hint: in double quotes so YAML parses it as a string instead of a flow-sequence array. Fixes GitHub Copilot CLI ≥ 1.0.65 silently dropping the skill.

- argument-hint: [foo]
+ argument-hint: "[foo]"

Bare [...] is YAML flow-sequence syntax → the loader receives ["foo"] (a list), fails its str validation, and rejects the SKILL without an error. Claude Code, VS Code Agent Skills, and every other loader document argument-hint as a string; the quoted-string form is what all reference docs show.

Files (9)

  • commands/skills.md
  • commands/status.md
  • commands/map.md
  • commands/pause.md
  • commands/help.md
  • commands/list-todos.md
  • commands/rtk.md
  • commands/qa.md
  • commands/config.md

Verification

  • YAML round-trip via yaml.safe_load on every changed frontmatter reports argument-hint as str
  • No vulnerable value contained " or \, so bare double-quote wrapping is safe

Sources

… skills

`argument-hint: [foo]` YAML-parses as a flow sequence (array), not a
string. Downstream slash-command loaders that validate `argument-hint`
as a string — notably GitHub Copilot CLI ≥ 1.0.65 — silently reject
the skill on load, and the command disappears from the CLI menu.

Wrap the value in double quotes so it parses as a string. No behaviour
change on Claude Code.
Copilot AI review requested due to automatic review settings July 13, 2026 16:12

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR fixes a YAML frontmatter type mismatch that causes GitHub Copilot CLI ≥ 1.0.65 to silently drop affected VBW commands/skills: argument-hint values that used bare [...] are now quoted so they parse as a string instead of a YAML flow-sequence list.

Changes:

  • Quote argument-hint: values in 9 command markdown files to force YAML string parsing.
  • Preserve the existing rendered hint text (still includes the bracketed usage examples), while making the frontmatter loader-compatible.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file
File Description
commands/skills.md Quote argument-hint so loaders treat it as a string.
commands/status.md Quote argument-hint so loaders treat it as a string.
commands/map.md Quote argument-hint so loaders treat it as a string.
commands/pause.md Quote argument-hint so loaders treat it as a string.
commands/help.md Quote argument-hint so loaders treat it as a string.
commands/list-todos.md Quote argument-hint so loaders treat it as a string.
commands/rtk.md Quote argument-hint so loaders treat it as a string.
commands/qa.md Quote argument-hint so loaders treat it as a string.
commands/config.md Quote argument-hint so loaders treat it as a string.

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.

Skills fail to load in GitHub Copilot CLI ≥1.0.65 due to array-shaped argument-hint

2 participants