Use verb-object skill names

This commit is contained in:
tmk241
2026-08-11 16:47:12 +02:00
parent 5552014329
commit cb555a41b2
7 changed files with 26 additions and 26 deletions
+3 -3
View File
@@ -25,7 +25,7 @@ If the repository is already under `/opt/repositories`:
Install selected skills only: Install selected skills only:
```sh ```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: 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 | | 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. | | `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 ## Agent definitions and policy
+2 -2
View File
@@ -24,8 +24,8 @@ Exit status:
Examples: Examples:
ink-skills list ink-skills list
ink-skills install ink-cli configure-ink-agent ink-skills install audit-ink-cli configure-ink-agent
ink-skills install --project . create-ink-agent-cli-tool ink-skills install --project . create-ink-tool
EOF EOF
} }
@@ -1,5 +1,5 @@
--- ---
name: ink-cli name: audit-ink-cli
description: >- description: >-
Use when the user explicitly asks an agent to audit, troubleshoot, or explain 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 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. selection, context handover, startup snapshots, or gaps in those surfaces.
Do not load it merely because ordinary work runs under Ink. External executables 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. changes belong to Ink's repository authority and implementation workflow.
## Host boundary and authority ## 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. 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 Negative smoke: “Build a selector-aware GitHub reader for Ink” routes to
`create-ink-agent-cli-tool`. `create-ink-tool`.
+2 -2
View File
@@ -26,8 +26,8 @@ project's `.ink/agents` directory, or when deciding the policy of a named Ink
child. child.
Do not load for launching an existing child, editing Ink source, installing Do not load for launching an existing child, editing Ink source, installing
skills, or creating an external executable. `ink-cli` owns host audits; skills, or creating an external executable. `audit-ink-cli` owns host audits;
`create-ink-agent-cli-tool` owns permission-bearing external tools. `create-ink-tool` owns permission-bearing external tools.
## Current definition contract ## Current definition contract
@@ -1,5 +1,5 @@
--- ---
name: create-ink-agent-cli-tool name: create-ink-tool
description: >- description: >-
Use when creating, implementing, splitting, or reviewing a compiled, Use when creating, implementing, splitting, or reviewing a compiled,
permission-bearing executable intended for admission through Ink policy. permission-bearing executable intended for admission through Ink policy.
@@ -8,7 +8,7 @@ description: >-
ordinary or one-off CLIs/scripts, or skill authoring. ordinary or one-off CLIs/scripts, or skill authoring.
--- ---
# Create Ink agent CLI tool # Create an Ink tool
## One job ## One job
+10 -10
View File
@@ -8,16 +8,16 @@ mkdir -p "$tmp/home" "$tmp/project"
list=$($repo/bin/ink-skills list) list=$($repo/bin/ink-skills list)
printf '%s\n' "$list" | grep '^SKILL' >/dev/null 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 printf '%s\n' "$list" | grep '^configure-ink-agent' >/dev/null
HOME=$tmp/home $repo/bin/ink-skills install ink-cli >"$tmp/install.tsv" HOME=$tmp/home $repo/bin/ink-skills install audit-ink-cli >"$tmp/install.tsv"
grep "ink-cli.*linked" "$tmp/install.tsv" >/dev/null grep "audit-ink-cli.*linked" "$tmp/install.tsv" >/dev/null
[ -L "$tmp/home/.ink/skills/ink-cli" ] [ -L "$tmp/home/.ink/skills/audit-ink-cli" ]
[ "$(readlink "$tmp/home/.ink/skills/ink-cli")" = "$repo/skills/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" HOME=$tmp/home $repo/bin/ink-skills install audit-ink-cli >"$tmp/reinstall.tsv"
grep "ink-cli.*unchanged" "$tmp/reinstall.tsv" >/dev/null grep "audit-ink-cli.*unchanged" "$tmp/reinstall.tsv" >/dev/null
mkdir -p "$tmp/home/.ink/skills/configure-ink-agent" 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 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 fi
grep 'refusing existing path' "$tmp/collision.err" >/dev/null 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" HOME=$tmp/home $repo/bin/ink-skills install --project "$tmp/project" create-ink-tool >"$tmp/project.tsv"
[ -L "$tmp/project/.ink/skills/create-ink-agent-cli-tool" ] [ -L "$tmp/project/.ink/skills/create-ink-tool" ]
grep "create-ink-agent-cli-tool.*linked" "$tmp/project.tsv" >/dev/null grep "create-ink-tool.*linked" "$tmp/project.tsv" >/dev/null
printf 'ok\n' printf 'ok\n'
+4 -4
View File
@@ -24,11 +24,11 @@ grep 'access.*read.*write' "$configure" >/dev/null
grep 'named agent policy is metadata-only' "$configure" >/dev/null grep 'named agent policy is metadata-only' "$configure" >/dev/null
grep 'no `INK_AGENT_HOME` contract' "$configure" >/dev/null grep 'no `INK_AGENT_HOME` contract' "$configure" >/dev/null
ink_cli=$repo/skills/ink-cli/SKILL.md audit_cli=$repo/skills/audit-ink-cli/SKILL.md
grep 'ink agent catalog' "$ink_cli" >/dev/null grep 'ink agent catalog' "$audit_cli" >/dev/null
grep 'frozen `tool delegate` subject' "$ink_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 'stage/match/apply' "$create_tool" >/dev/null
grep 'projection' "$create_tool" >/dev/null grep 'projection' "$create_tool" >/dev/null