Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add iii-hq/iii --skill iii-observe -a claude-code
Open on GitHub

What 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-tick with a schedule expression
  • catch only failed calls using capture: ["error"] with an input field filter
  • build a custom event source using onObserverAdded and onObservationDeliver hooks

Example prompts for the agent

  • Subscribe alerts::big-order to every successful orders::create call using iii.observe
  • Set up an observer on payments::charge with filter input.amount >= 500 and capture: ["error", "caller"]
  • Bind orders::create to POST /orders by observing http::on-request with the appropriate args

How to install iii-observe

1Skills CLI (Vercel)

npx skills add iii-hq/iii --skill iii-observe -a claude-code

2Manually: put the files in place

~/.claude/skills/iii-observe/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/iii-observe/

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.

Similar skills

All skills for Backend and APIs →

From the same set8

iii-engine-config iii-engine-config — a skill for Claude Code and Codex that guides engine configuration across Compose files and direct YAML specs. Configures network listeners, sandbox adapters, observer bounds, and RBAC proxies. CX Codex +1 5,200installs iii-error-handling iii-error-handling is a Claude Code skill that reads iii engine and SDK error codes, distinguishes network failures from access denials, and assesses safe retries for remote calls. CX Codex +1 5,000installs iii-sdk-reference Skill with iii SDK reference for Node.js, Python, Rust, Go, and browser environments. Covers worker registration, function calls, observers, channels, logging, and OpenTelemetry with code examples for each language. CX Codex +1 4,900installs iii-core-primitives The iii-core-primitives Claude Code skill covers iii function calls, event observers, and worker management. It applies when an agent needs to register functions, inspect the engine registry, or connect work to an event. CX Codex +1 4,900installs iii-architecture-patterns The iii-architecture-patterns Claude Code skill maps backend requirements to architecture patterns built from iii primitives. It covers queued workflows, observers, event-driven designs, and agent handoffs. CX Codex +1 4,900installs presentation Turns a technical-spec directory into an interactive web presentation. Use it when a specification needs a shareable deck with a clear narrative. CX Codex +1 4,400installs iii-observability The iii-observability skill gives the iii engine tracing, structured logs, metrics with rollups, alerts, and sampling via OpenTelemetry. Call engine::* functions to emit and query telemetry; bind a log trigger to react to every entry. CX Codex +1 195installs

Project sponsors

Companies that keep this analytics open