iii-getting-started
Install the iii engine, set up your first worker, and get a working backend running. Use when a user wants to start a new iii project, install the SDK, or needs help with initial setup and configuration.
Security Assessment
About iii-getting-started
This skill is the onboarding guide for iii, a backend engine that positions itself as a single replacement for an API framework, task queue, cron scheduler, pub/sub system, state store, and observability pipeline. It reduces backend development to three primitives — Function, Trigger, and Worker — and the skill walks an AI agent (or developer) through installing the engine, scaffolding a project, starting the engine, and wiring up a first working HTTP endpoint. The problem it solves is the friction of standing up a new backend across disparate services: instead of assembling multiple tools, the user gets one engine and a guided quickstart.
The workflow is a linear six-step path: install the engine via the official install script, run `iii create` to scaffold from a template, start the engine (which listens on a local WebSocket for workers and exposes a REST API and console on localhost ports), install a language SDK (TypeScript, Python, or Rust), register a first function plus an HTTP trigger, and test it with a curl request. It also documents adding pre-built capabilities from a worker registry (`iii worker add`), pinning them in an `iii.lock` file, cron and queue trigger patterns, state persistence via `state::get`/`state::set`, and installing the full set of agent skills. Numerous links point to the upstream iii documentation.
The target users are backend developers and AI coding agents starting a new iii project or needing initial setup and configuration help. It is most useful for first-worker guidance and quickstart scenarios; it explicitly defers to sibling skills (core primitives, SDK reference, engine config, architecture patterns, error handling) for deeper topics, positioning itself as the entry point rather than a comprehensive reference.
FAQ
What does iii replace?
According to the skill, iii replaces your API framework, task queue, cron scheduler, pub/sub, state store, and observability pipeline with a single engine built around three primitives: Function, Trigger, and Worker.
Which languages are supported?
The skill provides SDK installation and first-worker examples for TypeScript/Node.js, Python, and Rust. The default quickstart template includes workers in all three.
How do I install the engine?
You install it by running the official install script from install.iii.dev via curl, then verify with `iii --version`. After that you scaffold a project with `iii create` and start the engine against an `iii-config.yaml`.
How do I add existing capabilities instead of writing them?
Browse the worker registry at workers.iii.dev and run `iii worker add <name>`, which writes project config, installs and starts the worker, and records a pin in `iii.lock` so other machines can replay the same set with `iii worker sync`.
Does this skill cover advanced configuration and error handling?
No. It is scoped to installation, initial setup, and first-worker guidance, and it defers deeper topics to sibling skills such as iii-core-primitives, iii-sdk-reference, iii-engine-config, iii-architecture-patterns, and iii-error-handling.
Install iii-getting-started
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
iii-hq/iii