Skip to content

Quote argument-hint values starting with [ so Copilot CLI 1.0.65 loads skills#10

Open
thejesh23 wants to merge 1 commit into
dlt:mainfrom
thejesh23:fix/copilot-cli-1.0.65-argument-hint-string
Open

Quote argument-hint values starting with [ so Copilot CLI 1.0.65 loads skills#10
thejesh23 wants to merge 1 commit into
dlt:mainfrom
thejesh23:fix/copilot-cli-1.0.65-argument-hint-string

Conversation

@thejesh23

@thejesh23 thejesh23 commented Jul 3, 2026

Copy link
Copy Markdown

Summary

Copilot CLI 1.0.65 fails to load slash commands whose YAML frontmatter has an unquoted argument-hint value beginning with [. YAML parses the value as a flow sequence (array), but Copilot CLI expects a string, so the affected skills silently fail to register.

Three plugin skills currently trip this:

  • plugin/skills/spike/SKILL.mdargument-hint: [duration like 1h, 4h, 1d — default 1h]
  • plugin/skills/stats/SKILL.mdargument-hint: [period]
  • plugin/skills/trace/SKILL.mdargument-hint: [endpoint | trace-id]

The fix wraps each value in double quotes so YAML parses it as a string. Behavior for users on older Copilot CLI versions and for Claude Code is unchanged (the display text is identical); this just makes the frontmatter conform to Copilot CLI 1.0.65's stricter type check.

YAML rule

  • argument-hint: [X]argument-hint: "[X]"
  • argument-hint: ["X"]argument-hint: "X"

argument-hint values starting with < (e.g. <error-group-id>) are unaffected — YAML only treats a leading [ as a flow sequence.

References

Test plan

  • Confirmed the three edited files parse as YAML with argument-hint as a str (not list) via yaml.safe_load.
  • Scanned the full tree for other SKILL.md frontmatter with a leading [ after argument-hint: — no additional occurrences.
  • Load the plugin in Copilot CLI 1.0.65 and verify /spike, /stats, and /trace register.

Copilot CLI 1.0.65 fails to load slash commands whose YAML frontmatter has
an unquoted argument-hint value starting with '['. YAML parses the value as
a flow sequence (array), but Copilot expects a string, so the skill silently
fails to register.

Wrap the affected argument-hint values in double quotes so YAML parses them
as strings. Affects spike, stats, and trace skills.
@thejesh23

Copy link
Copy Markdown
Author

Tracking issue: #11 — captures the bug diagnosis and reproducer separately for anyone searching the repo who lands there before this PR.

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.

1 participant