Skip to content

Quote argument-hint so YAML parses it as string#5

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

Quote argument-hint so YAML parses it as string#5
thejesh23 wants to merge 1 commit into
xiaoheizi8:mainfrom
thejesh23:fix/copilot-cli-1.0.65-argument-hint-string

Conversation

@thejesh23

@thejesh23 thejesh23 commented Jul 3, 2026

Copy link
Copy Markdown

Summary

The frontmatter in SKILL.md currently declares:

argument-hint: [crush-name-or-slug]

Unquoted square brackets are YAML flow-sequence syntax, so this parses as a list of one string (["crush-name-or-slug"]) rather than the intended string "[crush-name-or-slug]".

Copilot CLI 1.0.65 tightened its skill/prompt frontmatter schema and now requires argument-hint to be a string. With the current value, loading this skill fails schema validation. Quoting the value keeps the same rendered hint while satisfying the string requirement:

argument-hint: "[crush-name-or-slug]"

This also matches the YAML rule cited in the related fixes below:

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

Claude Code and other consumers accept the quoted form without behavior change, so this is a safe, backward-compatible fix.

Related

Test plan

  • YAML round-trip: parsing the updated frontmatter with yaml.safe_load yields argument-hint of type str with value "[crush-name-or-slug]" (previously a 1-element list).
  • Only one file in the repo carried this pattern (SKILL.md); a full-tree scan for argument-hint returns no other occurrences.
  • Load the skill in Copilot CLI 1.0.65 and confirm it no longer fails schema validation.
  • Confirm the hint still renders identically in Claude Code / other consumers.

Copilot CLI 1.0.65 requires argument-hint to be a string. Unquoted
brackets ([crush-name-or-slug]) are parsed by YAML as a flow sequence,
which fails schema validation. Wrapping the value in double quotes
keeps it a string while preserving the display text.
@thejesh23

Copy link
Copy Markdown
Author

Tracking issue: #6 — 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