From 7531840bf365c1bb646f58c30fafe2a790bfc4e1 Mon Sep 17 00:00:00 2001 From: Rohit Ghumare Date: Thu, 4 Jun 2026 16:19:01 +0100 Subject: [PATCH 1/2] docs(workers): add skills install instructions to worker READMEs Add a Skills section to each worker README that ships an agent skill (coder, database, email, iii-directory, shell) plus the root README, documenting npx skills add for single, multi, and full-repo installs. --- README.md | 26 ++++++++++++++++++++++++++ coder/README.md | 15 +++++++++++++++ database/README.md | 15 +++++++++++++++ email/README.md | 15 +++++++++++++++ iii-directory/README.md | 17 +++++++++++++++++ shell/README.md | 15 +++++++++++++++ 6 files changed, 103 insertions(+) diff --git a/README.md b/README.md index 242993c9..86d9b4c2 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,32 @@ useful. Workers are installed via `iii worker add `, which resolves the matching asset for the host from the workers registry API. +## Skills + +Each worker ships an agent skill under `/skills/`. Install them with the +`skills` CLI (works with Claude Code, Cursor, and 30+ other agents). + +```bash +# List every worker skill in this repo +npx skills add iii-hq/workers --list + +# Install one worker's skill +npx skills add iii-hq/workers --skill email + +# Install several +npx skills add iii-hq/workers --skill email,coder,shell + +# Install all worker skills at once +npx skills add iii-hq/workers --all +``` + +For the iii engine's top-level skills (mental model, SDKs, config, patterns), +see [`iii-hq/iii`](https://github.com/iii-hq/iii): + +```bash +npx skills add iii-hq/iii --all +``` + ## Modules | Worker | Kind | Summary | diff --git a/coder/README.md b/coder/README.md index 13581a44..879bbac5 100644 --- a/coder/README.md +++ b/coder/README.md @@ -17,6 +17,21 @@ iii worker add coder `~/.iii/config.yaml`, and the engine starts the worker on the next `iii start`. +## Skills + +Install the `coder` agent skill for Claude Code, Cursor, and 30+ other agents: + +```bash +npx skills add iii-hq/workers --skill coder +``` + +Browse or install every worker skill at once: + +```bash +npx skills add iii-hq/workers --list +npx skills add iii-hq/workers --all +``` + ## Quickstart ```rust diff --git a/database/README.md b/database/README.md index 31f4bf58..f70047dc 100644 --- a/database/README.md +++ b/database/README.md @@ -15,6 +15,21 @@ iii worker add database@1.0.0 ``` +## Skills + +Install the `database` agent skill for Claude Code, Cursor, and 30+ other agents: + +```bash +npx skills add iii-hq/workers --skill database +``` + +Browse or install every worker skill at once: + +```bash +npx skills add iii-hq/workers --list +npx skills add iii-hq/workers --all +``` + ## Configure Runtime settings live in the **`configuration` worker** under id **`database`**. The worker registers its JSON Schema at startup, reads the live value via `configuration::get`, and hot-reloads connection pools when the value changes. diff --git a/email/README.md b/email/README.md index 5e7cb69a..8514c158 100644 --- a/email/README.md +++ b/email/README.md @@ -16,6 +16,21 @@ iii worker add harness/auth-credentials iii worker add email ``` +## Skills + +Install the `email` agent skill for Claude Code, Cursor, and 30+ other agents: + +```bash +npx skills add iii-hq/workers --skill email +``` + +Browse or install every worker skill at once: + +```bash +npx skills add iii-hq/workers --list +npx skills add iii-hq/workers --all +``` + ## Quickstart ```rust diff --git a/iii-directory/README.md b/iii-directory/README.md index eb49de35..6d98e0e6 100644 --- a/iii-directory/README.md +++ b/iii-directory/README.md @@ -59,6 +59,23 @@ iii worker add iii-directory --- +## Skills + +Install the `iii-directory` agent skill for Claude Code, Cursor, and 30+ other agents: + +```bash +npx skills add iii-hq/workers --skill iii-directory +``` + +Browse or install every worker skill at once: + +```bash +npx skills add iii-hq/workers --list +npx skills add iii-hq/workers --all +``` + +--- + ## Configuration ```yaml diff --git a/shell/README.md b/shell/README.md index 6bcb0225..0ab35954 100644 --- a/shell/README.md +++ b/shell/README.md @@ -15,6 +15,21 @@ iii worker add iii-sandbox iii worker add iii-directory ``` +## Skills + +Install the `shell` agent skill for Claude Code, Cursor, and 30+ other agents: + +```bash +npx skills add iii-hq/workers --skill shell +``` + +Browse or install every worker skill at once: + +```bash +npx skills add iii-hq/workers --list +npx skills add iii-hq/workers --all +``` + ## Configure Settings load from a YAML file passed with `--config ` (default `./config.yaml`). The worker refuses to start unless `fs.host_root` is set, or `fs.allow_unjailed: true` is explicitly opted in, because an unset root exposes the whole host filesystem behind only the advisory denylist. From 30041aa7f26ff6e42e812e67ab493b16683d5a23 Mon Sep 17 00:00:00 2001 From: Rohit Ghumare Date: Thu, 4 Jun 2026 16:46:19 +0100 Subject: [PATCH 2/2] docs(workers): use database as the single-skill install example --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 86d9b4c2..0a2bd858 100644 --- a/README.md +++ b/README.md @@ -18,10 +18,10 @@ Each worker ships an agent skill under `/skills/`. Install them with the npx skills add iii-hq/workers --list # Install one worker's skill -npx skills add iii-hq/workers --skill email +npx skills add iii-hq/workers --skill database # Install several -npx skills add iii-hq/workers --skill email,coder,shell +npx skills add iii-hq/workers --skill database,coder,shell # Install all worker skills at once npx skills add iii-hq/workers --all