# Send Twinfold to your agent
Use the source page and any available docs to guide the install because the item is currently unstable or timing out.
## Fast path
- Open the source page via Review source status.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "twinfold",
    "name": "Twinfold",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/lpbaril/twinfold",
    "canonicalUrl": "https://clawhub.ai/lpbaril/twinfold",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/twinfold",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twinfold",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/workflows.md"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "twinfold",
      "status": "unstable",
      "reason": "timeout",
      "recommendedAction": "retry_later",
      "checkedAt": "2026-05-10T06:32:07.885Z",
      "expiresAt": "2026-05-10T18:32:07.885Z",
      "httpStatus": null,
      "finalUrl": null,
      "contentType": null,
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twinfold",
        "error": "Timed out after 5000ms",
        "slug": "twinfold"
      },
      "scope": "item",
      "summary": "Item is unstable.",
      "detail": "This item is timing out or returning errors right now. Review the source page and try again later.",
      "primaryActionLabel": "Review source status",
      "primaryActionHref": "https://clawhub.ai/lpbaril/twinfold"
    },
    "validation": {
      "installChecklist": [
        "Wait for the source to recover or retry later.",
        "Review SKILL.md only after the download returns a real package.",
        "Treat this source as transient until the upstream errors clear."
      ],
      "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/twinfold",
    "downloadUrl": "https://openagent3.xyz/downloads/twinfold",
    "agentUrl": "https://openagent3.xyz/skills/twinfold/agent",
    "manifestUrl": "https://openagent3.xyz/skills/twinfold/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/twinfold/agent.md"
  }
}
```
## Documentation

### Twinfold Skill

Control Twinfold — the AI thought leadership platform — via its MCP API.

### Setup

The user needs a Twinfold API key. Check env var TWINFOLD_API_KEY.

If missing, tell the user:

Go to twinfold.app → Settings → API Keys
Create a key (starts with twf_)
Set it: export TWINFOLD_API_KEY=twf_... or add to .env

### API

Endpoint: POST https://twinfold.app/api/mcp/tools
Auth: Authorization: Bearer <TWINFOLD_API_KEY>
Body: { "tool": "twinfold.<toolName>", "arguments": { ... } }

All calls return { "result": { ... } } on success or { "error": "..." } on failure.

### Discover tools

curl https://twinfold.app/api/mcp/tools

Returns all 34 tools with schemas. No auth required.

### Content Creation

ToolUsecreatePostGenerate a post with AI. Supports multilingual, images, first comments, per-platform adaptation, auto-publishcreateArticleGenerate long-form articles with Twin knowledgeadaptContentRewrite content for a specific platform's culture and formatgenerateHooksGet 4 viral hook options with engagement scoresgenerateImageGenerate an AI image and attach to a postrepurposeContentTurn any text into multi-platform draft postsplanContentGenerate a multi-day content calendar with draft posts

### Content Management

ToolUsegetPostRead a single post with full detailslistPostsList posts (filter by status/platform)updatePostEdit content, platforms, media, scheduledeletePostRemove draft/scheduled postslistArticlesList articles

### Publishing

ToolUsepublishNowPublish immediately to connected platformsschedulePostSchedule for a future date/time

### Autopilot

ToolUserunAutopilotTrigger full autopilot pipeline (discover → create → publish)getAutopilotQueueList posts pending reviewapprovePostApprove for scheduled publicationrejectPostReject an autopilot post

### Intelligence

ToolUsequeryTwinAsk the AI Twin questions based on user's expertiseaddKnowledgeTeach the Twin new knowledgegetTrendsFetch trending topics scored by relevance

### Brand Guide & Voice

ToolUsegetBrandGuideGet the brand guide markdownsetBrandGuideUpdate brand guide (free, no credits)generateBrandGuideAI-generate brand guide from Twin knowledge (5 credits)listBrandVoicesList all brand voice profilescreateBrandVoiceCreate a brand voice manuallyupdateBrandVoiceUpdate an existing brand voicedeleteBrandVoiceDelete a brand voicegenerateBrandVoiceAI-generate a brand voice analysis (5 credits)

### Notifications

ToolUsegetNotificationsList notifications (unread, by type, paginated)markNotificationReadMark one or all notifications as readgetNotificationPreferencesGet notification channel preferences

### Account

ToolUselistAccountsConnected social accounts + content languagesgetCreditsCredit balance, plan, cost tablegetAnalyticsPost stats and workspace analytics

### Common Workflows

For detailed tool schemas and workflow examples, read references/workflows.md.

### Quick: Create and publish a post

1. twinfold.createPost { topic, platforms, language, autoAdapt: true, autoPublish: true }

One call does it all — generates content, adapts per platform, publishes.

### Quick: Create, review, then publish

1. twinfold.createPost { topic, platforms, language }  → postId
2. Show content to user, let them edit
3. twinfold.updatePost { postId, content: editedContent }
4. twinfold.publishNow { postId }

### Full pipeline with images and hooks

1. twinfold.generateHooks { topic }  → pick best hook
2. twinfold.createPost { topic, platforms, language, generateImage: true, generateFirstComment: true }  → postId
3. twinfold.getPost { postId }  → review
4. twinfold.publishNow { postId }

### Platforms

LinkedIn · Twitter/X · Instagram · Facebook · YouTube · TikTok · Pinterest · Threads · Reddit · Bluesky

### Languages

English · French · Quebec French (fr-CA) · Spanish · German · Portuguese · Brazilian Portuguese · Italian · Dutch · Japanese · Korean · Chinese · Arabic

Set language per social account or per API call. Content generates natively (not translated).

### Credit Costs

OperationCreditsPost10Article50Hook simulation5Image10First comment2Twin query2Brand guide generate5Brand voice generate5

Always check twinfold.getCredits before heavy operations.

### Error Handling

401 → Invalid API key
402 → Insufficient credits (check with getCredits)
400 → Bad arguments (error message explains what's wrong)
429 → Rate limited (wait and retry)

### Tips

Use autoAdapt: true on createPost to get platform-optimized versions automatically
Set language: "fr-CA" for authentic Quebec French content
Use getTrends → createPost for trend-jacking workflows
repurposeContent turns blog posts, transcripts, or notes into social posts
planContent creates a full week of drafts in one call
Autopilot runs daily — use getAutopilotQueue + approvePost for review workflows
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: lpbaril
- Version: 1.0.3
## Source health
- Status: unstable
- Item is unstable.
- This item is timing out or returning errors right now. Review the source page and try again later.
- Health scope: item
- Reason: timeout
- Checked at: 2026-05-10T06:32:07.885Z
- Expires at: 2026-05-10T18:32:07.885Z
- Recommended action: Review source status
## Links
- [Detail page](https://openagent3.xyz/skills/twinfold)
- [Send to Agent page](https://openagent3.xyz/skills/twinfold/agent)
- [JSON manifest](https://openagent3.xyz/skills/twinfold/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/twinfold/agent.md)
- [Download page](https://openagent3.xyz/downloads/twinfold)