migrating-persona-to-relayflow

Installation
SKILL.md

Migrating a persona to Relayflow v1

v1 engine. This skill targets the superseded @relayflows/core engine via ctx.workflow.run(). The current engine is v2 — @relayflows/surface / @relayflows/sdk, CLI flows — documented in writing-relayflows. Use this skill only to move an existing persona onto v1's durable execution today.

When to use this skill

You are working on a persona in AgentWorkforce/agents or AgentWorkforce/internal-agents that today does its work inline in a defineAgent({ handler }) — LLM calls via ctx.llm(...), ranking, curation, review — and you want to move the LLM-heavy portion behind a durable Relayflow v1 workflow via ctx.workflow.run() so that the work is exactly-once resumable, journaled, and step-level retriable.

Read the RFC first: docs/RFC-0001-everything-is-a-relayflow.md. This skill is the practical recipe; the RFC is why.

Reference migration to imitate: hn-monitor — agents#126, evidence at hn-monitor/evidence/2026-09-03-relayflow-v1.md.

Do not use this skill for

Installs
1
GitHub Stars
5
First Seen
Oct 15, 2026