iii-observe — Claude Code skill: observers, events, filters
A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that teaches the agent how to wire iii functions together with iii.observe.
no license 1,100 installs ★ 18,938 updated 2026-11-09
npx skills add iii-hq/iii --skill iii-observe -a claude-codeWhat iii-observe does
The skill covers the full observer API in the iii framework: basic two-argument iii.observe(a, b) calls, filter expressions, capture configuration, and options like max_in_flight and expires_in_ms. All examples span TypeScript, Python, Rust, Go, and the browser SDK.
In iii, every event is a function call: an HTTP request is a call of http::on-request, a cron tick of cron::on-tick, a row change of database::on-row-changed. Observing one of these source functions — with the right args — is how a handler binds to that event. The capture field controls which parts of the observed call (input, output, error, caller) the target receives. A capture list that omits all of input, output, and error causes the engine to return INVALID_ARGS.
For custom event sources, the skill covers four lifecycle hooks: onObserverAdded, onObserverRemoved, onObservationMatch, and onObservationDeliver. The observer stays in pending state until the target function is registered, so registration order matters.
What it helps with
- chain an alert function to every successful call of another function
- bind a request handler to an HTTP route via
http::on-request - set up a cron job by observing
cron::on-tickwith a schedule expression - catch only failed calls using
capture: ["error"]with an input field filter - build a custom event source using
onObserverAddedandonObservationDeliverhooks
Example prompts for the agent
- Subscribe
alerts::big-orderto every successfulorders::createcall usingiii.observe - Set up an observer on
payments::chargewith filterinput.amount >= 500andcapture: ["error", "caller"] - Bind
orders::createto POST/ordersby observinghttp::on-requestwith the appropriate args
How to install iii-observe
1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a claude-code2Manually: put the files in place
~/.claude/skills/iii-observe/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/iii-observe/
1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a codex2Manually: put the files in place
.agents/skills/iii-observe/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a cursor2Manually: put the files in place
.cursor/skills/iii-observe/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install iii-hq/iii skills/iii-observe2Manually: put the files in place
.github/skills/iii-observe/SKILL.md1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a gemini-cli2Platform CLI
gemini skills install https://github.com/iii-hq/iii --path skills/iii-observeManually: put the files in place
.devin/skills/iii-observe/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about iii-observe
How do I install iii-observe in Claude Code?
Run npx skills add iii-hq/iii --skill iii-observe -a claude-code. The skill file lands at ~/.claude/skills/iii-observe/SKILL.md.
What does the iii-observe skill do?
It gives the agent the knowledge to write iii.observe calls: connecting functions, subscribing to HTTP, cron, queue, state, and database events, configuring filters and capture fields, and authoring custom event sources.
Which languages does iii-observe cover?
TypeScript (Node and browser), Python, Rust, and Go. The skill includes working observer examples with filters and capture for each of them.