From 5bfc84b5e1b6a40bb2c3b7b07304cb43b78a02a0 Mon Sep 17 00:00:00 2001 From: thejesh Date: Fri, 3 Jul 2026 01:01:21 -0700 Subject: [PATCH] fix(skills): quote argument-hint so Copilot CLI 1.0.65 parses it as string The `argument-hint:` frontmatter field on eight SKILL.md files was written as an unquoted bracketed value (e.g. `[optional ADR topic]`). YAML interprets unquoted `[...]` as a flow sequence, so the field parsed as an array instead of a string. Copilot CLI 1.0.65 tightened its schema to require `argument-hint` to be a string, which now rejects these files at load time. Claude Code currently tolerates the array form but the same root cause is tracked upstream in anthropics/claude-code#22161. Fix by quoting each affected value so YAML parses it as a plain string. The migrate skill hint contains inner double quotes, so it uses single-quoted YAML to avoid escape gymnastics. No behavior change intended: the rendered hint text remains identical; only the YAML type of the field changes from sequence to string. Refs: Egonex-AI/Understand-Anything#540, anthropics/claude-code#22161 --- .claude/skills/adr-writer/SKILL.md | 2 +- .claude/skills/commit/SKILL.md | 2 +- .claude/skills/detach/SKILL.md | 2 +- .claude/skills/guard-writer/SKILL.md | 2 +- .claude/skills/init/SKILL.md | 2 +- .claude/skills/migrate/SKILL.md | 2 +- .claude/skills/rfc-writer/SKILL.md | 2 +- .claude/skills/wi-writer/SKILL.md | 2 +- 8 files changed, 8 insertions(+), 8 deletions(-) diff --git a/.claude/skills/adr-writer/SKILL.md b/.claude/skills/adr-writer/SKILL.md index 10df1015..fc84a417 100644 --- a/.claude/skills/adr-writer/SKILL.md +++ b/.claude/skills/adr-writer/SKILL.md @@ -2,7 +2,7 @@ name: adr-writer description: "Write effective Architecture Decision Records. Use when: (1) Creating a new ADR, (2) Recording a design decision, (3) User mentions ADR, decision, trade-off, or alternatives" allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional ADR topic] +argument-hint: "[optional ADR topic]" --- # ADR Writer diff --git a/.claude/skills/commit/SKILL.md b/.claude/skills/commit/SKILL.md index 7758b264..a623d000 100644 --- a/.claude/skills/commit/SKILL.md +++ b/.claude/skills/commit/SKILL.md @@ -2,7 +2,7 @@ name: commit description: "Commit changes with govctl integration — check work item status, preserve durable notes only when needed, and run govctl check" allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional commit message hint] +argument-hint: "[optional commit message hint]" --- # /commit — Commit with Govctl Integration diff --git a/.claude/skills/detach/SKILL.md b/.claude/skills/detach/SKILL.md index 4f0e8c48..a6cc825e 100644 --- a/.claude/skills/detach/SKILL.md +++ b/.claude/skills/detach/SKILL.md @@ -2,7 +2,7 @@ name: detach description: "Remove govctl governance from a project. Archives artifacts, removes skills/agents, strips code references. Use when: (1) User wants to stop using govctl, (2) User mentions detach, opt-out, remove governance, or uninstall" allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional scope hint] +argument-hint: "[optional scope hint]" --- # /detach — Remove govctl Governance diff --git a/.claude/skills/guard-writer/SKILL.md b/.claude/skills/guard-writer/SKILL.md index 7ee50c6b..c95ccf92 100644 --- a/.claude/skills/guard-writer/SKILL.md +++ b/.claude/skills/guard-writer/SKILL.md @@ -2,7 +2,7 @@ name: guard-writer description: "Write well-structured Verification Guards. Use when: (1) Creating a new guard, (2) Editing guard check commands or patterns, (3) User mentions guard, verification, or check" allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional guard topic] +argument-hint: "[optional guard topic]" --- # Guard Writer diff --git a/.claude/skills/init/SKILL.md b/.claude/skills/init/SKILL.md index 4994f7dc..f8283aab 100644 --- a/.claude/skills/init/SKILL.md +++ b/.claude/skills/init/SKILL.md @@ -2,7 +2,7 @@ name: init description: "Set up govctl in the current project. Installs the binary if missing, initializes governance structure." allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional setup scope] +argument-hint: "[optional setup scope]" --- # /init - Set Up Govctl diff --git a/.claude/skills/migrate/SKILL.md b/.claude/skills/migrate/SKILL.md index 77ccc718..6653c606 100644 --- a/.claude/skills/migrate/SKILL.md +++ b/.claude/skills/migrate/SKILL.md @@ -2,7 +2,7 @@ name: migrate description: "Adopt govctl in an existing project. Discovers undocumented decisions, backfills ADRs/RFCs, annotates source code. Use when: (1) Project has no governance yet, (2) User mentions migrate, adopt, onboard, or brownfield" allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional scope hint, e.g. "focus on database decisions"] +argument-hint: '[optional scope hint, e.g. "focus on database decisions"]' --- # /migrate — Adopt govctl in an Existing Project diff --git a/.claude/skills/rfc-writer/SKILL.md b/.claude/skills/rfc-writer/SKILL.md index 4785d331..8857b6ef 100644 --- a/.claude/skills/rfc-writer/SKILL.md +++ b/.claude/skills/rfc-writer/SKILL.md @@ -2,7 +2,7 @@ name: rfc-writer description: "Write well-structured RFCs with normative clauses. Use when: (1) Creating a new RFC, (2) Adding or editing RFC clauses, (3) User mentions RFC, specification, or normative requirements" allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional RFC topic] +argument-hint: "[optional RFC topic]" --- # RFC Writer diff --git a/.claude/skills/wi-writer/SKILL.md b/.claude/skills/wi-writer/SKILL.md index d2a839a9..ee13e695 100644 --- a/.claude/skills/wi-writer/SKILL.md +++ b/.claude/skills/wi-writer/SKILL.md @@ -2,7 +2,7 @@ name: wi-writer description: "Write well-structured work items with proper acceptance criteria. Use when: (1) Creating work items, (2) Adding acceptance criteria, (3) User mentions work item, task, WI, or ticket" allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite -argument-hint: [optional work-item topic] +argument-hint: "[optional work-item topic]" --- # Work Item Writer