diff --git a/README.md b/README.md
index 242993c9..0a2bd858 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,32 @@ useful.
 Workers are installed via `iii worker add <name>`, which resolves the matching
 asset for the host from the workers registry API.
 
+## Skills
+
+Each worker ships an agent skill under `<worker>/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 database
+
+# Install several
+npx skills add iii-hq/workers --skill database,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 <path>` (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.