docs(workers): skills install instructions in worker READMEs

[rohitg00]

What

Adds a ## Skills section to every worker README that ships an agent skill, plus the repo root README, so users can install worker skills with the skills CLI.

Changes

• Per-worker ## Skills block in coder, database, email, iii-directory, shell READMEs, each with npx skills add iii-hq/workers --skill <name>.
• Root README.md gains a ## Skills section covering list, single, multi, and all-at-once installs, with a pointer to iii-hq/iii for engine top-level skills.

Notes

• Documentation only. No code or worker behavior changes.
• Worker skills live at <worker>/skills/SKILL.md. The repo has no root SKILL.md, so default skills CLI discovery picks them up. Worth a npx skills add iii-hq/workers --list smoke test before merge to confirm the names resolve.

Summary by CodeRabbit

• Documentation
  • Added "Skills" sections to the main README and all worker READMEs describing how to install and manage agent skills via the skills CLI, including commands to list available skills, install a specific worker skill, install multiple skills, and install all worker skills at once.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
workers	Ready	Preview, Comment	Jun 4, 2026 3:46pm

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: aab42bb7-90a3-4774-9de8-0742e45c2b17

📥 Commits

Reviewing files that changed from the base of the PR and between 7531840 and 30041aa.

📒 Files selected for processing (1)

• README.md

✅ Files skipped from review due to trivial changes (1)

• README.md

---

📝 Walkthrough

Walkthrough

Documentation across the repository is extended to explain agent skills installation. The root README establishes the skills discovery pattern and CLI usage, while five worker-specific READMEs add parallel Skills sections documenting installation commands for each respective agent skill.

Changes

Skills Installation Documentation

Layer / File(s)	Summary
Root-level skills documentation and patterns README.md	Introduces the Skills section explaining per-worker skill locations under <worker>/skills/, installation via npx skills CLI, example commands for listing and installing skills, and reference to engine-level skills in iii-hq/iii.
Worker-specific skill installation guides coder/README.md, database/README.md, email/README.md, iii-directory/README.md, shell/README.md	Each worker README adds a Skills section with installation commands specific to that worker's skill and instructions for browsing or installing all worker skills via --list and --all flags.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Suggested reviewers

• sergiofilhowz

Poem

🐰 I hopped through READMEs, sniffed each line,
and tucked small skills in folders fine.
"npx skills add"—a carrot cheer,
now workers share what agents hear,
docs gleam like clover in the shine. 🌿

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs(workers): skills install instructions in worker READMEs' clearly and concisely summarizes the main change—adding Skills sections with installation instructions to worker README files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch skills/install-instructions

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

skill-check — worker

0 verified, 14 skipped (no docs/).

Layer	Result
structure	✓
vale	✓
ai	✓
render	✓

Four for four. Nicely done.