Use verb-object skill names

2026-08-11 16:47:12 +02:00
parent 5552014329
commit cb555a41b2
7 changed files with 26 additions and 26 deletions
@@ -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

@@ -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
 }

@@ -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`.
@@ -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

@@ -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

@@ -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'
@@ -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