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:
persona.ts(definePersona({...})) declares deployment metadata and runtime wiring, and points at the handler viaonEvent: './agent.ts'. It compiles topersona.json(a generated, gitignored artifact — authorpersona.ts, never the compiled JSON).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.)