iii-architecture-patterns — Claude Code skill: features and setup
This skill maps backend requirements to iii architecture patterns, from queued workflows to event-driven designs. Use it when a task spans more than one function or trigger.
npx skills add iii-hq/iii --skill iii-architecture-patterns -a claude-codeWhat iii-architecture-patterns does
The skill shows how to combine iii functions, triggers, workers, state, queues, streams, and pub/sub around a chosen architecture. Its examples cover workflows with step tracking, state-driven updates, and side effects that react to function calls or failures.
Other patterns include agent handoffs through named queues, event-based CQRS, and synchronous composition of small functions. Code samples use TypeScript, Python, and Rust. Observer activations run without waiting for completion; when a side effect needs retries, the target function must enqueue that work.
What it helps with
- chain workflow steps through named queues
- track progress across workflow stages
- push updates when state changes
- record audit events after a function call
- hand tasks from one AI agent to another
Example prompts for the agent
- Design an iii workflow with retries and progress tracking across its steps.
- Add an audit side effect after
orders::createwithout changing that function. - Show how to pass work between agents using a named queue.
How to install iii-architecture-patterns
1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-architecture-patterns -a claude-code2Manually: put the files in place
~/.claude/skills/iii-architecture-patterns/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/iii-architecture-patterns/
1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-architecture-patterns -a codex2Manually: put the files in place
.agents/skills/iii-architecture-patterns/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-architecture-patterns -a cursor2Manually: put the files in place
.cursor/skills/iii-architecture-patterns/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install iii-hq/iii iii-architecture-patterns2Manually: put the files in place
.github/skills/iii-architecture-patterns/SKILL.md1Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-architecture-patterns -a gemini-cli2Platform CLI
gemini skills install https://github.com/iii-hq/iii --path skills/iii-architecture-patternsManually: put the files in place
.devin/skills/iii-architecture-patterns/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-architecture-patterns -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-architecture-patterns
How do I install iii-architecture-patterns in Claude Code?
Run npx skills add iii-hq/iii --skill iii-architecture-patterns -a claude-code. The skill file is at ~/.claude/skills/iii-architecture-patterns/SKILL.md.
What does iii-architecture-patterns do?
It helps select backend patterns and combine iii primitives for workflows, event-driven systems, observers, and agent handoffs.
Can an observer failure break the function it watches?
No. An observer failure does not affect the observed call. Activations are fire-and-forget, so enqueue the target work when it needs retries.
