runtype-personalisted
Install: claude install-skill runtypelabs/skills
# Runtype Persona
Persona is the embeddable chat UI for Runtype `chat` surfaces. Use this skill for website
widgets, assistant layouts, theming, artifacts, and local browser tools.
## Required First Calls
When MCP is available:
- Use `get_platform_documentation(topic="persona-embed")` for current embed docs.
- Use `get_platform_documentation(topic="persona-fullscreen-assistant")` for fullscreen
split-pane assistant layouts.
- Use `get_persona_theme_reference` before custom themes.
- Use `generate_persona_embed_code` for final snippets whenever possible.
- Read `runtype://types/surface-configs` directly when surface behavior config details
matter.
Do not hand-write embed code unless the MCP tools are unavailable.
## Critical Constants
- Package: `@runtypelabs/persona`.
- Global script: `https://cdn.jsdelivr.net/npm/@runtypelabs/persona@latest/dist/install.global.js`.
- ESM entry: `https://cdn.jsdelivr.net/npm/@runtypelabs/persona@latest/dist/index.js`.
- CSS for ESM/npm usage: `@runtypelabs/persona/widget.css`.
- Init function: `initAgentWidget()`.
- Ready event: `persona:ready`.
Common wrong answers: `@runtype/persona`, `Persona.mount()`, `window.Persona`,
`index.umd.js`, missing `widget.css`, or `widget:ready`.
## Build Pattern
1. Create or identify the product, agent/flow capability, and `chat` surface.
2. Create a scoped client token with `create_client_token`.
3. Generate embed code with `generate_persona_embed_code`.
4. For consumer-facing widgets, hide too