From 43a4463978513361b06ef5ac9b04e330e12130da Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20Padez?= Date: Sat, 29 Aug 2026 01:35:29 +0100 Subject: [PATCH] the platform skill generator emits an identifier, not a label MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit c24859c fixed every skill's `name` to be lowercase-hyphenated and equal to its directory, with the human name moving to `title`. it fixed the FILES. this generator writes one of those files and was missed. so the file on disk was correct and running `bun run skills:platform` put the old shape back — which made `docs:check` fail on a line count that could not be fixed by regenerating, the worst possible place for a drift check to point. found while cutting a release, because the procedure says leave docs:check green and it was not. Co-Authored-By: Claude Opus 5 --- scripts/gen-platform-skill.ts | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/scripts/gen-platform-skill.ts b/scripts/gen-platform-skill.ts index 04db2fc2..ee732594 100644 --- a/scripts/gen-platform-skill.ts +++ b/scripts/gen-platform-skill.ts @@ -60,7 +60,17 @@ export async function renderPlatformSkill(): Promise { const out = (s = '') => lines.push(s); out('---'); - out('name: Officer platform'); + /* + `name` is an IDENTIFIER, not a label: lowercase-hyphenated and equal to the directory, per both + harnesses' rules. The human name is `title`. + + This generator emitted `name: Officer platform` and was missed when c24859c fixed every skill by + hand — so the file on disk was right and running this script put the old shape back. `docs:check` + then failed on a line count that nobody could fix by regenerating, which is the worst place for a + drift check to point. + */ + out('name: platform'); + out('title: Officer platform'); // The description is the ENTIRE interface: the agent sees only this before deciding to open the body. // Vague makes a skill useless rather than merely verbose — see skills/load.ts. out('description: >-');