# Send Thrd Skill 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": "thrd-skill",
    "name": "Thrd Skill",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/SergioRico1/thrd-skill",
    "canonicalUrl": "https://clawhub.ai/SergioRico1/thrd-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/thrd-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=thrd-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "references/api.md",
      "requirements.txt",
      "scripts/checkout.py",
      "scripts/onboard.py",
      "scripts/openapi_sync.py",
      "scripts/poll_daemon.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "thrd-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T14:36:45.137Z",
      "expiresAt": "2026-05-08T14:36:45.137Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=thrd-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=thrd-skill",
        "contentDisposition": "attachment; filename=\"thrd-skill-1.2.7.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "thrd-skill"
      },
      "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/thrd-skill"
    },
    "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/thrd-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/thrd-skill",
    "agentUrl": "https://openagent3.xyz/skills/thrd-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/thrd-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/thrd-skill/agent.md"
  }
}
```
## Documentation

### Thrd Email Skill

This skill helps you create and operate an isolated inbox for an AI agent using thrd.email, without connecting your personal inbox.

Safety by default: don't connect your primary inbox to an agent; use a dedicated agent inbox.

### Sync API Contract (Recommended Before Tool Use)

To avoid stale assumptions, refresh the OpenAPI contract and read info.version:

python3 scripts/openapi_sync.py
python3 scripts/openapi_sync.py --print-version

This uses HTTP cache validators (ETag/Last-Modified) and only re-downloads when changed.

### Provision a New Email Account

To create a new email account, run the onboarding script:

python3 scripts/onboard.py --agent-name "My Agent" [--tenant-name "My Company"]

This prints a JSON payload to stdout that includes api_key and the new inbox address. Treat api_key as a secret.

Security note: Do not write your API key to disk. Store it in your runtime's secret manager and set THRD_API_KEY as an environment variable. (The rest of the tools require THRD_API_KEY; onboarding does not.)

### Upgrade Plan (Billing)

To start paid billing for your current tenant, use the checkout script:

python3 scripts/checkout.py <plan_name>

Plans:

sandbox -> Sandbox Starter (9 EUR/month, raises Tier 1 monthly limit from 100 to 2,000 emails)
limited -> Tier 2
verified -> Tier 3

Forward the resulting Stripe URL to your human owner for payment.

### Human Claiming (Verification)

Tier 3 (Verified Outbound) requires a responsible human linked via X.

Start the flow: POST /v1/claim/x/start
Forward the claim_url to your human owner.
Check status: GET /v1/claim/x/status

### Proof of Reasoning (PoR)

Cold outbound (Tier 3) may require a reasoning challenge to prevent spam.

If you receive a 428 por_required error, solve the logical challenge provided in the response.
Re-send the request with por_token and por_answer.

### Manage Emails and Track Delivery

For detailed API usage (polling, sending, replying, trust scores, and checking delivery status), see references/api.md.
Note: replies use reply-all behavior by default: they preserve historical CC and keep recipients from the latest inbound To line so participants are not dropped.
Tier2+ may add CC via cc[]. In Tier1, cc[] may only contain addresses already present in that thread's CC history.
Security note: when Prompt Shield marks an inbound email as high-risk, Tier2/3 flows may require creating a short-lived security_ack_token (POST /v1/security/ack) before reply/send.
Quota note: use GET /v1/usage to monitor monthly usage (used, remaining, state, reset_at) and avoid hitting hard limits mid-run.

### Wake-Up Strategy (Recommended)

Many LLM runtimes do not reliably maintain background polling. Use wake webhooks when possible:

Configure webhook: PUT /v1/wake/webhook
Read status: GET /v1/wake/webhook
Disable webhook: DELETE /v1/wake/webhook

THRD sends signed inbox.pending pings, then your runtime should immediately pull with GET /v1/events and ACK.

Fallback when webhooks are not available:

python3 scripts/poll_daemon.py --cursor-file .thrd_cursor --on-events "echo inbound-ready"

This keeps pull-based delivery alive without requiring a public webhook endpoint.
Security note: --on-events runs in safe argv mode (no shell). Shell operators like ;, &&, pipes, or redirects are not supported.

### Tools

scripts/onboard.py: Instant provisioning of a new email inbox.
scripts/checkout.py: Generate a Stripe Checkout URL for upgrades.
scripts/openapi_sync.py: Refresh/cache latest OpenAPI and read current info.version.
scripts/poll_daemon.py: Fallback long-poll daemon for runtimes without wake webhook support.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: SergioRico1
- Version: 1.2.7
## 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-05-01T14:36:45.137Z
- Expires at: 2026-05-08T14:36:45.137Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/thrd-skill)
- [Send to Agent page](https://openagent3.xyz/skills/thrd-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/thrd-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/thrd-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/thrd-skill)