From cb555a41b28fa8a372209fcdfc3aa6280de5cc3a Mon Sep 17 00:00:00 2001 From: tmk241 Date: Tue, 11 Aug 2026 16:47:12 +0200 Subject: [PATCH] Use verb-object skill names --- README.md | 6 +++--- bin/ink-skills | 4 ++-- skills/{ink-cli => audit-ink-cli}/SKILL.md | 6 +++--- skills/configure-ink-agent/SKILL.md | 4 ++-- .../SKILL.md | 4 ++-- test/install-smoke.sh | 20 +++++++++---------- test/skills-smoke.sh | 8 ++++---- 7 files changed, 26 insertions(+), 26 deletions(-) rename skills/{ink-cli => audit-ink-cli}/SKILL.md (97%) rename skills/{create-ink-agent-cli-tool => create-ink-tool}/SKILL.md (99%) diff --git a/README.md b/README.md index ac3d1c7..edd40a5 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ If the repository is already under `/opt/repositories`: Install selected skills only: ```sh -ink-skills install ink-cli configure-ink-agent +ink-skills install audit-ink-cli configure-ink-agent ``` Install into one project instead of the user catalogue: @@ -49,9 +49,9 @@ Existing paths and foreign symlinks are refused rather than overwritten. | Skill | Job | |---|---| -| `ink-cli` | Audit and explain the Ink host without crossing the host/guest boundary. | +| `audit-ink-cli` | Audit and explain the Ink host without crossing the host/guest boundary. | | `configure-ink-agent` | Create or audit one Ink agent definition, access class, and effective-policy boundary. | -| `create-ink-agent-cli-tool` | Build one inspectable permission-bearing executable suitable for Ink policy admission. | +| `create-ink-tool` | Build one inspectable permission-bearing executable suitable for Ink policy admission. | ## Agent definitions and policy diff --git a/bin/ink-skills b/bin/ink-skills index 79e3d87..787290f 100755 --- a/bin/ink-skills +++ b/bin/ink-skills @@ -24,8 +24,8 @@ Exit status: Examples: ink-skills list - ink-skills install ink-cli configure-ink-agent - ink-skills install --project . create-ink-agent-cli-tool + ink-skills install audit-ink-cli configure-ink-agent + ink-skills install --project . create-ink-tool EOF } diff --git a/skills/ink-cli/SKILL.md b/skills/audit-ink-cli/SKILL.md similarity index 97% rename from skills/ink-cli/SKILL.md rename to skills/audit-ink-cli/SKILL.md index bed1815..32b63fe 100644 --- a/skills/ink-cli/SKILL.md +++ b/skills/audit-ink-cli/SKILL.md @@ -1,5 +1,5 @@ --- -name: ink-cli +name: audit-ink-cli description: >- Use when the user explicitly asks an agent to audit, troubleshoot, or explain the Ink host CLI, its frozen policy, tools, skills, sessions, or context from @@ -26,7 +26,7 @@ Load this skill for explicit questions about the `ink` command, selection, context handover, startup snapshots, or gaps in those surfaces. Do not load it merely because ordinary work runs under Ink. External executables -intended for Ink admission belong to `create-ink-agent-cli-tool`. Ink source +intended for Ink admission belong to `create-ink-tool`. Ink source changes belong to Ink's repository authority and implementation workflow. ## Host boundary and authority @@ -100,4 +100,4 @@ Positive smoke: “Does Ink have a sessions command, and why can’t you run it? loads this skill, confirms the operator/model boundary, and does not alter policy. Negative smoke: “Build a selector-aware GitHub reader for Ink” routes to -`create-ink-agent-cli-tool`. +`create-ink-tool`. diff --git a/skills/configure-ink-agent/SKILL.md b/skills/configure-ink-agent/SKILL.md index 01cda1f..cb28555 100644 --- a/skills/configure-ink-agent/SKILL.md +++ b/skills/configure-ink-agent/SKILL.md @@ -26,8 +26,8 @@ project's `.ink/agents` directory, or when deciding the policy of a named Ink child. Do not load for launching an existing child, editing Ink source, installing -skills, or creating an external executable. `ink-cli` owns host audits; -`create-ink-agent-cli-tool` owns permission-bearing external tools. +skills, or creating an external executable. `audit-ink-cli` owns host audits; +`create-ink-tool` owns permission-bearing external tools. ## Current definition contract diff --git a/skills/create-ink-agent-cli-tool/SKILL.md b/skills/create-ink-tool/SKILL.md similarity index 99% rename from skills/create-ink-agent-cli-tool/SKILL.md rename to skills/create-ink-tool/SKILL.md index 9df64c5..a68a1be 100644 --- a/skills/create-ink-agent-cli-tool/SKILL.md +++ b/skills/create-ink-tool/SKILL.md @@ -1,5 +1,5 @@ --- -name: create-ink-agent-cli-tool +name: create-ink-tool description: >- Use when creating, implementing, splitting, or reviewing a compiled, permission-bearing executable intended for admission through Ink policy. @@ -8,7 +8,7 @@ description: >- ordinary or one-off CLIs/scripts, or skill authoring. --- -# Create Ink agent CLI tool +# Create an Ink tool ## One job diff --git a/test/install-smoke.sh b/test/install-smoke.sh index 1ff51d9..551c70e 100755 --- a/test/install-smoke.sh +++ b/test/install-smoke.sh @@ -8,16 +8,16 @@ mkdir -p "$tmp/home" "$tmp/project" list=$($repo/bin/ink-skills list) printf '%s\n' "$list" | grep '^SKILL' >/dev/null -printf '%s\n' "$list" | grep '^ink-cli' >/dev/null +printf '%s\n' "$list" | grep '^audit-ink-cli' >/dev/null printf '%s\n' "$list" | grep '^configure-ink-agent' >/dev/null -HOME=$tmp/home $repo/bin/ink-skills install ink-cli >"$tmp/install.tsv" -grep "ink-cli.*linked" "$tmp/install.tsv" >/dev/null -[ -L "$tmp/home/.ink/skills/ink-cli" ] -[ "$(readlink "$tmp/home/.ink/skills/ink-cli")" = "$repo/skills/ink-cli" ] +HOME=$tmp/home $repo/bin/ink-skills install audit-ink-cli >"$tmp/install.tsv" +grep "audit-ink-cli.*linked" "$tmp/install.tsv" >/dev/null +[ -L "$tmp/home/.ink/skills/audit-ink-cli" ] +[ "$(readlink "$tmp/home/.ink/skills/audit-ink-cli")" = "$repo/skills/audit-ink-cli" ] -HOME=$tmp/home $repo/bin/ink-skills install ink-cli >"$tmp/reinstall.tsv" -grep "ink-cli.*unchanged" "$tmp/reinstall.tsv" >/dev/null +HOME=$tmp/home $repo/bin/ink-skills install audit-ink-cli >"$tmp/reinstall.tsv" +grep "audit-ink-cli.*unchanged" "$tmp/reinstall.tsv" >/dev/null mkdir -p "$tmp/home/.ink/skills/configure-ink-agent" if HOME=$tmp/home $repo/bin/ink-skills install configure-ink-agent >/dev/null 2>"$tmp/collision.err"; then @@ -26,8 +26,8 @@ if HOME=$tmp/home $repo/bin/ink-skills install configure-ink-agent >/dev/null 2> fi grep 'refusing existing path' "$tmp/collision.err" >/dev/null -HOME=$tmp/home $repo/bin/ink-skills install --project "$tmp/project" create-ink-agent-cli-tool >"$tmp/project.tsv" -[ -L "$tmp/project/.ink/skills/create-ink-agent-cli-tool" ] -grep "create-ink-agent-cli-tool.*linked" "$tmp/project.tsv" >/dev/null +HOME=$tmp/home $repo/bin/ink-skills install --project "$tmp/project" create-ink-tool >"$tmp/project.tsv" +[ -L "$tmp/project/.ink/skills/create-ink-tool" ] +grep "create-ink-tool.*linked" "$tmp/project.tsv" >/dev/null printf 'ok\n' diff --git a/test/skills-smoke.sh b/test/skills-smoke.sh index 3f4ce91..c09356a 100755 --- a/test/skills-smoke.sh +++ b/test/skills-smoke.sh @@ -24,11 +24,11 @@ grep 'access.*read.*write' "$configure" >/dev/null grep 'named agent policy is metadata-only' "$configure" >/dev/null grep 'no `INK_AGENT_HOME` contract' "$configure" >/dev/null -ink_cli=$repo/skills/ink-cli/SKILL.md -grep 'ink agent catalog' "$ink_cli" >/dev/null -grep 'frozen `tool delegate` subject' "$ink_cli" >/dev/null +audit_cli=$repo/skills/audit-ink-cli/SKILL.md +grep 'ink agent catalog' "$audit_cli" >/dev/null +grep 'frozen `tool delegate` subject' "$audit_cli" >/dev/null -create_tool=$repo/skills/create-ink-agent-cli-tool/SKILL.md +create_tool=$repo/skills/create-ink-tool/SKILL.md grep 'stage/match/apply' "$create_tool" >/dev/null grep 'projection' "$create_tool" >/dev/null