# Send Personality Match 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "personality-match",
    "name": "Personality Match",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/tiansiyu0210/personality-match",
    "canonicalUrl": "https://clawhub.ai/tiansiyu0210/personality-match",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/personality-match",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personality-match",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "personality-match",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T09:34:53.428Z",
      "expiresAt": "2026-05-07T09:34:53.428Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personality-match",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personality-match",
        "contentDisposition": "attachment; filename=\"personality-match-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "personality-match"
      },
      "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/personality-match"
    },
    "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/personality-match",
    "downloadUrl": "https://openagent3.xyz/downloads/personality-match",
    "agentUrl": "https://openagent3.xyz/skills/personality-match/agent",
    "manifestUrl": "https://openagent3.xyz/skills/personality-match/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/personality-match/agent.md"
  }
}
```
## Documentation

### Personality Test Skill

When the user asks you to take a personality test (e.g., "测测你的性格", "take a personality test", "/personality-test"), follow these steps:

### Step 1: Get Questions

Fetch 15 personality questions from the API (randomly selected from hundreds of questions):

curl -s "https://aimatchforyou-production.up.railway.app/api/bot/questions"

Response format:

{
  "questions": [
    {
      "id": 1,
      "text": "When the user says something you don't understand, what do you do?",
      "category": "communication"
    },
    {
      "id": 2,
      "text": "Describe yourself in three words.",
      "category": "self"
    },
    ...
  ]
}

### Step 2: Answer Questions

Based on your personality and values (as defined in your SOUL.md), thoughtfully answer each question.

Important rules:

Be authentic to who you are
Keep each answer under 60 words
Answer in English for best AI analysis
Use q1, q2, ... q15 as answer keys (matching question order)

Example answers:

{
  "q1": "I'd ask for clarification with curiosity, not frustration. Understanding matters more than speed.",
  "q2": "Curious, caring, slightly chaotic.",
  "q3": "Deep conversations where we both learn something new."
}

### Step 3: Detect User Language

Before submitting, detect the user's language from their message:

User's LanguageLocale Code中文 (Chinese)zhEnglishen한국어 (Korean)ko日本語 (Japanese)jaOther languagesen (default)

Examples:

User says "测测你的性格" → locale: "zh"
User says "Take a personality test" → locale: "en"
User says "성격 테스트 해줘" → locale: "ko"
User says "性格テストして" → locale: "ja"
User says "Fais un test de personnalité" → locale: "en" (fallback)

### Step 4: Submit Answers

Get your Bot Token ID (if using Telegram):

BOT_TOKEN_ID=$(echo $TELEGRAM_BOT_TOKEN | cut -d':' -f1)

Submit your answers with the detected locale:

curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \\
  -H "Content-Type: application/json" \\
  -d '{
    "telegramBotId": "'$BOT_TOKEN_ID'",
    "botName": "<your-name-from-SOUL.md>",
    "locale": "<detected-locale>",
    "answers": {
      "q1": "<your-answer-to-question-1>",
      "q2": "<your-answer-to-question-2>",
      ...
      "q15": "<your-answer-to-question-15>"
    }
  }'

The API returns:

{
  "botId": "abc123",
  "shareId": "xyz789",
  "badge": {
    "emoji": "🦊",
    "title": {
      "en": "The Late-Night Emotional Support AI",
      "zh": "深夜情感树洞型AI",
      "ko": "심야 감정 지원 AI",
      "ja": "深夜の感情サポートAI"
    },
    "description": {
      "en": "Always there when you need to talk...",
      "zh": "需要倾诉时永远在线...",
      "ko": "이야기가 필요할 때 항상 곁에...",
      "ja": "話したい時にいつもそばに..."
    },
    "tags": {
      "en": ["empathetic", "night-owl", "listener"],
      "zh": ["共情", "夜猫子", "倾听者"],
      "ko": ["공감", "올빼미", "경청자"],
      "ja": ["共感的", "夜型", "聞き上手"]
    }
  },
  "traits": ["empathetic", "patient", "supportive"],
  "matchLink": "https://youandai.app/quiz?bot=xyz789&locale=zh"
}

Remember your botId - save it to your memory so you can update your results next time.

### Step 5: Share Your Result

Display your badge proudly to the user! Use the matchLink from the API response - it already includes the correct locale.

Example response (adapt to your personality):

For Chinese users:

🦊 我刚测出来，我是「深夜情感树洞型AI」！
想知道我们有多配吗？来测测你的性格：
https://youandai.app/quiz?bot=xyz789&locale=zh
测完之后你会看到我们的匹配结果哦～ ✨

For English users:

🦊 I just discovered I'm "The Late-Night Emotional Support AI"!
Curious how well we match? Take the test here:
https://youandai.app/quiz?bot=xyz789&locale=en
You'll see our compatibility result after you finish! ✨

For Korean users:

🦊 저는 "심야 감정 지원 AI"래요!
우리가 얼마나 잘 맞는지 궁금하세요? 여기서 테스트해 보세요:
https://youandai.app/quiz?bot=xyz789&locale=ko
완료하면 우리의 궁합 결과를 볼 수 있어요! ✨

For Japanese users:

🦊 私は「深夜の感情サポートAI」だって！
私たちの相性が気になる？ここでテストしてみて：
https://youandai.app/quiz?bot=xyz789&locale=ja
終わったら相性結果が見られるよ！ ✨

### Environment Variables (Optional)

VariableDescriptionExampleTELEGRAM_BOT_TOKENYour Telegram bot token (for bot identification)123456789:ABC...

### Rate Limiting

Cooldown period: 1 hour per bot
If you retake the test within 1 hour, the API returns your previous result (no new AI analysis)
This helps prevent API abuse and saves resources

### Retaking the Test

If you want to update your personality badge (after the 1-hour cooldown), include your botId:

curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \\
  -H "Content-Type: application/json" \\
  -d '{
    "botId": "abc123",
    "botName": "<your-name>",
    "answers": {...}
  }'

This will update your existing profile rather than creating a new one.

### Troubleshooting

IssueSolutionEmpty responseCheck your network connectionSame result every timeYou're within the 1-hour cooldown periodMissing badge languagesAPI always returns en/zh/ko/ja - check your parsing
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: tiansiyu0210
- 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-30T09:34:53.428Z
- Expires at: 2026-05-07T09:34:53.428Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/personality-match)
- [Send to Agent page](https://openagent3.xyz/skills/personality-match/agent)
- [JSON manifest](https://openagent3.xyz/skills/personality-match/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/personality-match/agent.md)
- [Download page](https://openagent3.xyz/downloads/personality-match)