From b01a82cd6136b5b8eabc8f53f75cfc8a400ca33c Mon Sep 17 00:00:00 2001 From: thejesh Date: Fri, 3 Jul 2026 00:50:26 -0700 Subject: [PATCH] fix(skills): make argument-hint a YAML string, not a one-element list MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The `argument-hint:` frontmatter field in all 9 SKILL.md files was written as `argument-hint: ["..."]`, which is YAML flow-sequence syntax. YAML parses it as a one-element list `["..."]`, not as a string `"..."`. GitHub Copilot CLI 1.0.65 (released 2026-06) tightened its skill loader to require `argument-hint` to be a string, so all 9 DoneGraph skills silently fail to load in Copilot CLI 1.0.65+. The same shape is also a latent bug on Claude Code, tracked at anthropics/claude-code#22161 — Claude Code currently accepts either shape but the docs specify string. Fix: strip the outer `[` and `]` so each value is a plain YAML double-quoted string. References ---------- - GitHub Copilot CLI release notes / changelog for 1.0.65 - VS Code Agent Skills docs: `argument-hint` documented as a string (single-line prompt hint), not an array - Copilot CLI skills tutorial (`copilot-cli-for-beginners/05-skills`) also shows `argument-hint` as a plain string - Diagnostic reference: Egonex-AI/Understand-Anything#540 documents the same root cause with sources (currently open, not yet merged — cited as diagnostic reference only) Verified: `yaml.safe_load` on all 9 files now returns `str` for `argument-hint`, matching what Copilot CLI, VS Code, and Claude Code expect. --- plugins/donegraph/skills/donegraph-capture/SKILL.md | 2 +- plugins/donegraph/skills/donegraph-checkpoint/SKILL.md | 2 +- plugins/donegraph/skills/donegraph-dashboard/SKILL.md | 2 +- plugins/donegraph/skills/donegraph-done/SKILL.md | 2 +- plugins/donegraph/skills/donegraph-proof/SKILL.md | 2 +- plugins/donegraph/skills/donegraph-recap/SKILL.md | 2 +- plugins/donegraph/skills/donegraph-start/SKILL.md | 2 +- plugins/donegraph/skills/donegraph-summary/SKILL.md | 2 +- plugins/donegraph/skills/donegraph/SKILL.md | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/plugins/donegraph/skills/donegraph-capture/SKILL.md b/plugins/donegraph/skills/donegraph-capture/SKILL.md index 1111aca..79adcbb 100644 --- a/plugins/donegraph/skills/donegraph-capture/SKILL.md +++ b/plugins/donegraph/skills/donegraph-capture/SKILL.md @@ -1,7 +1,7 @@ --- name: donegraph-capture description: Automatically capture local project context into a clean-room DoneGraph collaboration graph. -argument-hint: ["[--goal ] [--platform codex|claude|cursor|generic]"] +argument-hint: "[--goal ] [--platform codex|claude|cursor|generic]" --- # /donegraph-capture diff --git a/plugins/donegraph/skills/donegraph-checkpoint/SKILL.md b/plugins/donegraph/skills/donegraph-checkpoint/SKILL.md index bcb0f8e..ed781e9 100644 --- a/plugins/donegraph/skills/donegraph-checkpoint/SKILL.md +++ b/plugins/donegraph/skills/donegraph-checkpoint/SKILL.md @@ -1,7 +1,7 @@ --- name: donegraph-checkpoint description: Record a meaningful DoneGraph progress checkpoint for the current AI collaboration. -argument-hint: [" [--command ] [--path ]"] +argument-hint: " [--command ] [--path ]" --- # /donegraph-checkpoint diff --git a/plugins/donegraph/skills/donegraph-dashboard/SKILL.md b/plugins/donegraph/skills/donegraph-dashboard/SKILL.md index 9ce98fb..66db337 100644 --- a/plugins/donegraph/skills/donegraph-dashboard/SKILL.md +++ b/plugins/donegraph/skills/donegraph-dashboard/SKILL.md @@ -1,7 +1,7 @@ --- name: donegraph-dashboard description: Build and open the local DoneGraph dashboard for the current project. -argument-hint: ["[--no-open]"] +argument-hint: "[--no-open]" --- # /donegraph-dashboard diff --git a/plugins/donegraph/skills/donegraph-done/SKILL.md b/plugins/donegraph/skills/donegraph-done/SKILL.md index fdb0d64..d00740a 100644 --- a/plugins/donegraph/skills/donegraph-done/SKILL.md +++ b/plugins/donegraph/skills/donegraph-done/SKILL.md @@ -1,7 +1,7 @@ --- name: donegraph-done description: Record a DoneGraph completion milestone and regenerate handoff artifacts. -argument-hint: [""] +argument-hint: "" --- # /donegraph-done diff --git a/plugins/donegraph/skills/donegraph-proof/SKILL.md b/plugins/donegraph/skills/donegraph-proof/SKILL.md index 5031b50..e49db5e 100644 --- a/plugins/donegraph/skills/donegraph-proof/SKILL.md +++ b/plugins/donegraph/skills/donegraph-proof/SKILL.md @@ -1,7 +1,7 @@ --- name: donegraph-proof description: Record verification evidence in DoneGraph, including pass, fail, blocked, or unknown status. -argument-hint: [" --pass|--fail|--blocked|--unknown [--command ]"] +argument-hint: " --pass|--fail|--blocked|--unknown [--command ]" --- # /donegraph-proof diff --git a/plugins/donegraph/skills/donegraph-recap/SKILL.md b/plugins/donegraph/skills/donegraph-recap/SKILL.md index e22a274..dc34e8a 100644 --- a/plugins/donegraph/skills/donegraph-recap/SKILL.md +++ b/plugins/donegraph/skills/donegraph-recap/SKILL.md @@ -1,7 +1,7 @@ --- name: donegraph-recap description: One-click session recap. AI-analyzes git history, runs checks, and generates a visual dashboard with narrative story, insights, and risks. -argument-hint: ["[--last ] [--since