From 2a7fbafa776da5317e68bfddd460fb1b117f7d14 Mon Sep 17 00:00:00 2001 From: Julian Noble Date: Thu, 6 Aug 2026 14:52:19 +1000 Subject: [PATCH] tcl-whatis/tcl-nslist skills: kit Tcl-version note (punk91=9.1, punk905=9.0, punksys=8.6) The skills pinned bin/punk91 but never stated which Tcl it embeds, and the "any punkshell kit works" fallback was unqualified - Tcl-version-sensitive introspection questions (e.g. 8.6-vs-9 builtin differences) left the agent to work out kit versions unaided, in a bin/ full of non-kit exes. Add one sentence to each skill's Command section: punk91 embeds Tcl 9.1; for Tcl-version-sensitive questions, or if punk91 is unavailable, use punk905 (Tcl 9.0) or punksys (Tcl 8.6) with the same command line. Stated versions smoke-verified against the live kits (9.1b0 / 9.0.5 / 8.6.13). Canonical .agents/skills copies edited; .claude/skills re-copied and diff-verified byte-identical per the root AGENTS.md sync convention. Frontmatter descriptions untouched, so skill firing is unchanged. Claude-Session: https://claude.ai/code/session_01Y1diJnhjUxKgEG6EwYAzxj Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com --- .agents/skills/tcl-nslist/SKILL.md | 5 ++++- .agents/skills/tcl-whatis/SKILL.md | 5 ++++- .claude/skills/tcl-nslist/SKILL.md | 5 ++++- .claude/skills/tcl-whatis/SKILL.md | 5 ++++- 4 files changed, 16 insertions(+), 4 deletions(-) diff --git a/.agents/skills/tcl-nslist/SKILL.md b/.agents/skills/tcl-nslist/SKILL.md index c5484ea5..a59f1fe9 100644 --- a/.agents/skills/tcl-nslist/SKILL.md +++ b/.agents/skills/tcl-nslist/SKILL.md @@ -15,7 +15,10 @@ auto-loads the providing package when the namespace is not yet populated. ## Command Run from the repo root (`punk91` lives in `bin/`, so `bin/punk91` from the -Bash tool; any punkshell kit works). Cost: sub-1s, no side effects. +Bash tool; any punkshell kit works). `punk91` embeds Tcl 9.1; for +Tcl-version-sensitive questions, or if punk91 is unavailable, use `punk905` +(Tcl 9.0) or `punksys` (Tcl 8.6) with the same command line. Cost: sub-1s, +no side effects. punk91 src script lib:developer/nslist ?-synopsis? ?-pathcommands? ... diff --git a/.agents/skills/tcl-whatis/SKILL.md b/.agents/skills/tcl-whatis/SKILL.md index b83b8d27..9d1ca979 100644 --- a/.agents/skills/tcl-whatis/SKILL.md +++ b/.agents/skills/tcl-whatis/SKILL.md @@ -14,7 +14,10 @@ zipfs) is actually loaded. ## Command Run from the repo root (`punk91` lives in `bin/`, so `bin/punk91` from the -Bash tool; any punkshell kit works). Cost: sub-1s, no side effects. +Bash tool; any punkshell kit works). `punk91` embeds Tcl 9.1; for +Tcl-version-sensitive questions, or if punk91 is unavailable, use `punk905` +(Tcl 9.0) or `punksys` (Tcl 8.6) with the same command line. Cost: sub-1s, +no side effects. punk91 src script lib:developer/whatis ?-body? ?-doc? ?subcommand?... diff --git a/.claude/skills/tcl-nslist/SKILL.md b/.claude/skills/tcl-nslist/SKILL.md index c5484ea5..a59f1fe9 100644 --- a/.claude/skills/tcl-nslist/SKILL.md +++ b/.claude/skills/tcl-nslist/SKILL.md @@ -15,7 +15,10 @@ auto-loads the providing package when the namespace is not yet populated. ## Command Run from the repo root (`punk91` lives in `bin/`, so `bin/punk91` from the -Bash tool; any punkshell kit works). Cost: sub-1s, no side effects. +Bash tool; any punkshell kit works). `punk91` embeds Tcl 9.1; for +Tcl-version-sensitive questions, or if punk91 is unavailable, use `punk905` +(Tcl 9.0) or `punksys` (Tcl 8.6) with the same command line. Cost: sub-1s, +no side effects. punk91 src script lib:developer/nslist ?-synopsis? ?-pathcommands? ... diff --git a/.claude/skills/tcl-whatis/SKILL.md b/.claude/skills/tcl-whatis/SKILL.md index b83b8d27..9d1ca979 100644 --- a/.claude/skills/tcl-whatis/SKILL.md +++ b/.claude/skills/tcl-whatis/SKILL.md @@ -14,7 +14,10 @@ zipfs) is actually loaded. ## Command Run from the repo root (`punk91` lives in `bin/`, so `bin/punk91` from the -Bash tool; any punkshell kit works). Cost: sub-1s, no side effects. +Bash tool; any punkshell kit works). `punk91` embeds Tcl 9.1; for +Tcl-version-sensitive questions, or if punk91 is unavailable, use `punk905` +(Tcl 9.0) or `punksys` (Tcl 8.6) with the same command line. Cost: sub-1s, +no side effects. punk91 src script lib:developer/whatis ?-body? ?-doc? ?subcommand?...