creating-cloud-persona

Installation
SKILL.md

Creating Cloud Persona

Use this skill when authoring a deployable Workforce persona in the current shape.

Core rule

A cloud persona is two files that ship as a pair:

  1. persona.ts (definePersona({...})) declares deployment metadata and runtime wiring, and points at the handler via onEvent: './agent.ts'. It compiles to persona.json (a generated, gitignored artifact — author persona.ts, never the compiled JSON).
  2. agent.ts (export default defineAgent({...})) implements the actual behavior.

Always ship both. The runtime's composable-runtime closure treats persona.ts as the canonical entry; a bare agent.ts with no sibling persona.ts falls back to a synthesized minimal-preview persona (and emits a compatibility warning) — you lose the real harness/model/integration/memory wiring. (The composable-runtime-closure acceptance harness in the agents repo pins this: it fails if a deploy synthesizes a persona instead of loading persona.ts.)

Installs
2
GitHub Stars
1
First Seen
Aug 15, 2026
creating-cloud-persona — agentworkforce/skills