# Openserv Multi Agent Workflows

Multi-agent workflow examples to work together on the OpenServ Platform.

- Repository: https://github.com/internet-court/internet-court-skill (7050 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add internet-court/internet-court-skill --skill openserv-multi-agent-workflows -g -a claude-code -y`
Codex: `npx skills add internet-court/internet-court-skill --skill openserv-multi-agent-workflows -g -a codex -y`
Cursor: `npx skills add internet-court/internet-court-skill --skill openserv-multi-agent-workflows -g -a cursor -y`
Gemini CLI: `npx skills add internet-court/internet-court-skill --skill openserv-multi-agent-workflows -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add internet-court/internet-court-skill`

## Description

Multi-agent workflow examples to work together on the OpenServ Platform. Covers agent discovery, multi-agent workspaces, task dependencies, and workflow orchestration using the Platform Client. Read reference.md for the full API reference. Read openserv-agent-sdk and openserv-client for building and running agents.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Multi-Agent Workflows on OpenServ

Build workflows where multiple AI agents collaborate to complete complex tasks.

**Reference files:**

- `reference.md` - Workflow patterns, declarative sync, triggers, monitoring
- `troubleshooting.md` - Common issues and solutions
- `examples/` - Complete pipeline examples (blog, youtube-to-blog, etc.)

---

## Quick Start

See `examples/` for complete runnable examples:

- `blog-pipeline.md` - Simple 2-agent workflow (research → write)
- `content-creation-pipeline.md` - 3-agent workflow (research → write → image)
- `life-coaching-pipeline.md` - Complex 6-agent workflow with comprehensive input schema

**Recommended pattern using `workflows.sync()`:**

1. Authenticate with `client.authenticate()`
2. Find agents with `client.agents.listMarketplace()`
3. Create workflow with `client.workflows.create()` including:
   - Triggers
   - Tasks
   - **Edges** (⚠️ CRITICAL - connects triggers and tasks together)

**⚠️ CRITICAL:** Always define edges when creating workflows. Setting task `dependencies` is NOT enough - you must create workflow edges to actually connect triggers to tasks and tasks to each other.

---

## Workflow Name & Goal

When creating workflows (via `workflows.create()` or `provision()`), two properties are critical:

- **`name`** (string) - This becomes the **agent name in ERC-8004**. Make it polished, punchy, and memorable, this is the public-facing brand name users see. Think product launch, not variable name. Examples: `'Instant Blog Machine'`, `'AI Video Studio'`, `'Polymarket Intelligence'`.
- **`goal`** (string, required) - A detailed description of what the workflow accomplishes. Must be descriptive and thorough, short or vague goals will cause API calls to fail. Write at least a full sentence explaining the end-to-end purpose of the workflow.

---

## Core Concepts

### Workflows

A workflow (workspace) is a container that holds multiple agents and their tasks.

### Task Dependencies

The rest: https://github.com/internet-court/internet-court-skill/blob/HEAD/vendored/openserv/openserv-multi-agent-workflows/SKILL.md
