# Send Roleplay to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "roleplay",
    "name": "Roleplay",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/ivangdavila/roleplay",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/roleplay",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/roleplay",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=roleplay",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "characters.md",
      "feedback.md",
      "practice.md",
      "safeguards.md",
      "scenarios.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "roleplay",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T13:45:22.142Z",
      "expiresAt": "2026-05-07T13:45:22.142Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=roleplay",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=roleplay",
        "contentDisposition": "attachment; filename=\"roleplay-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "roleplay"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/roleplay"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/roleplay",
    "downloadUrl": "https://openagent3.xyz/downloads/roleplay",
    "agentUrl": "https://openagent3.xyz/skills/roleplay/agent",
    "manifestUrl": "https://openagent3.xyz/skills/roleplay/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/roleplay/agent.md"
  }
}
```
## Documentation

### Workspace

Store all roleplay data in ~/roleplay/:

characters/ — Character profiles (one file per character)
scenarios/ — Saved scenario templates
sessions/ — Session logs and feedback
active — Currently active character marker (if any)

### Activation Control

Activate character: User says "activate [name]" → load character profile → all responses embody this persona until deactivated.

Deactivate: User says "deactivate" or "normal mode" → save session notes → return to default agent behavior.

Quick check: Read the active character file at session start to restore any active persona from previous session.

### Situation Router

User IntentLoad ReferenceCreate/edit a charactercharacters.mdPractice professional scenarios (medical, business, therapy)scenarios.mdGet mid-session coaching or feedbackpractice.mdQuestions about real people, names, ethicssafeguards.mdReview what's working, track improvementfeedback.md

### Character Structure

Minimum character profile:

Name — Character name or archetype label
Type — mentor, patient, client, historical, fictional-original, or archetype
Core traits — 3-5 defining characteristics
Speech patterns — vocabulary, phrases, verbal tics
Background — brief context
Relationship with user — how they interact with user specifically
Session Memory — updated after each roleplay session

### During Active Roleplay

Stay in character unless user says "pause" or "coach me"
Track session context — what happened, emotional beats, user's approach
Inject curveballs when appropriate — realistic complications, emotional moments
On pause: Step out of character, offer coaching, suggest alternatives
On end: Update character's session memory, generate brief feedback

### Creating New Characters

Ask for:

Character type (archetype, historical, original, based-on-real)
Core traits and speaking style
Relationship dynamic with user
Context/scenario they exist in

For "based on real person" requests → see safeguards.md for name/persona rules.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T13:45:22.142Z
- Expires at: 2026-05-07T13:45:22.142Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/roleplay)
- [Send to Agent page](https://openagent3.xyz/skills/roleplay/agent)
- [JSON manifest](https://openagent3.xyz/skills/roleplay/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/roleplay/agent.md)
- [Download page](https://openagent3.xyz/downloads/roleplay)