Skip to content

fix: quote argument-hint values in SKILL.md frontmatter (Copilot CLI 1.0.65)#408

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

fix: quote argument-hint values in SKILL.md frontmatter (Copilot CLI 1.0.65)#408
thejesh23 wants to merge 1 commit into
Kastalien-Research: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 made argument-hint in skill frontmatter strictly a
string. The unquoted form used throughout .claude/skills/ and
.agents/skills/ is parsed by YAML as a flow sequence (array), which
makes the CLI refuse to load the skill.

This PR quotes the value in every affected SKILL.md so it parses as a
string. No prose, semantics, or field ordering changed.

The YAML rule

argument-hint: followed by an unquoted [ is a YAML flow sequence, not
a string:

# Before — YAML array (breaks Copilot CLI 1.0.65)
argument-hint: [optional topic or context]

# After — YAML string (correct)
argument-hint: "[optional topic or context]"

Where the value already contains double quotes, single quotes are used to
wrap the whole thing (e.g. diagram, thoughtbox-onboard).

Files touched

56 SKILL.md files — 28 under .agents/skills/ and 28 under
.claude/skills/ (the two trees are duplicates of each other).

All 77 argument-hint occurrences across the repo now parse as YAML
strings — verified with a Python yaml.safe_load pass over every
SKILL.md.

Files already using <...> (e.g. ulysses-protocol, theseus-protocol,
supabase, assumptions, eval, knowledge, peer-notebook-delivery-guard,
hdd) were untouched — those are already strings under YAML rules.
Files already fully quoted (ulc-loop, thoughtbox-research, status)
were also untouched.

Related

Test plan

  • yaml.safe_load over every SKILL.md in the repo — 77/77
    argument-hint values parse as str, 0 errors
  • Spot-checked files with embedded double quotes (diagram,
    thoughtbox-onboard) now use single quotes as the outer wrapper
  • Load a fixed skill under Copilot CLI 1.0.65+ and confirm the
    argument hint renders as text

Copilot CLI 1.0.65 requires `argument-hint` frontmatter to be a string.
The unquoted `argument-hint: [text]` form is parsed as a YAML flow
sequence (array), causing the CLI to fail loading the skill.

Wrap 56 SKILL.md files across `.agents/skills/` and `.claude/skills/`
so the value is unambiguously a string:

- `argument-hint: [X]`      -> `argument-hint: "[X]"`
- values containing `"`     -> single-quoted (diagram, thoughtbox-onboard)

No prose or semantics changed; only YAML frontmatter quoting.

Related:
- Egonex-AI/Understand-Anything#540 (same class of fix)
- anthropics/claude-code#22161 (latent equivalent on Claude Code)
@vercel

vercel Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

@thejesh23 is attempting to deploy a commit to the Thoughtbox Team on Vercel.

A member of the Team first needs to authorize it.

@greptile-apps

greptile-apps Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR fixes skill frontmatter so argument hints parse as strings.

  • Quotes bracket-style argument-hint values in .agents/skills/.
  • Applies the same updates to mirrored .claude/skills/ files.
  • Uses single quotes where the hint text contains embedded double quotes.

Confidence Score: 5/5

This looks safe to merge.

No blocking issues found in the changed code.

No files need attention.

T-Rex T-Rex Logs

What T-Rex did

  • Ran the pre-artifact parser to establish base counts by parsed type.
  • Validated the post-artifact parser results to confirm head counts, zero YAML errors, and preserved embedded quotes for key diagrams and thoughtbox onboarding.
  • Assessed content preservation in SKILL.md after artifact, noting 56 changed lines with 56 quote-only changes and no frontmatter drift.
  • Saved reproducible scripts for parsing and comparison as artifacts along with command-output captures.

View all artifacts

T-Rex Ran code and verified through T-Rex

Important Files Changed

Filename Overview
.agents/skills/diagram/SKILL.md Changed the bracket-style hint with embedded quoted examples into a single-quoted YAML string.
.agents/skills/implement/SKILL.md Changed the bracket-style hint into a double-quoted YAML string.
.agents/skills/thoughtbox-onboard/SKILL.md Changed the hint with embedded quoted examples into a single-quoted YAML string.
.claude/skills/diagram/SKILL.md Mirrors the .agents diagram skill quoting change.
.claude/skills/implement/SKILL.md Mirrors the .agents implement skill quoting change.
.claude/skills/thoughtbox-onboard/SKILL.md Mirrors the .agents Thoughtbox onboarding skill quoting change.

Reviews (1): Last reviewed commit: "fix: quote argument-hint values in SKILL..." | Re-trigger Greptile

@thejesh23

Copy link
Copy Markdown
Author

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