{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/twinfold",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twinfold",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/workflows.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/twinfold"
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/twinfold",
    "agentPageUrl": "https://openagent3.xyz/skills/twinfold/agent",
    "manifestUrl": "https://openagent3.xyz/skills/twinfold/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/twinfold/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Twinfold Skill",
        "body": "Control Twinfold — the AI thought leadership platform — via its MCP API."
      },
      {
        "title": "Setup",
        "body": "The user needs a Twinfold API key. Check env var TWINFOLD_API_KEY.\n\nIf missing, tell the user:\n\nGo to twinfold.app → Settings → API Keys\nCreate a key (starts with twf_)\nSet it: export TWINFOLD_API_KEY=twf_... or add to .env"
      },
      {
        "title": "API",
        "body": "Endpoint: POST https://twinfold.app/api/mcp/tools\nAuth: Authorization: Bearer <TWINFOLD_API_KEY>\nBody: { \"tool\": \"twinfold.<toolName>\", \"arguments\": { ... } }\n\nAll calls return { \"result\": { ... } } on success or { \"error\": \"...\" } on failure."
      },
      {
        "title": "Discover tools",
        "body": "curl https://twinfold.app/api/mcp/tools\n\nReturns all 34 tools with schemas. No auth required."
      },
      {
        "title": "Content Creation",
        "body": "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"
      },
      {
        "title": "Content Management",
        "body": "ToolUsegetPostRead a single post with full detailslistPostsList posts (filter by status/platform)updatePostEdit content, platforms, media, scheduledeletePostRemove draft/scheduled postslistArticlesList articles"
      },
      {
        "title": "Publishing",
        "body": "ToolUsepublishNowPublish immediately to connected platformsschedulePostSchedule for a future date/time"
      },
      {
        "title": "Autopilot",
        "body": "ToolUserunAutopilotTrigger full autopilot pipeline (discover → create → publish)getAutopilotQueueList posts pending reviewapprovePostApprove for scheduled publicationrejectPostReject an autopilot post"
      },
      {
        "title": "Intelligence",
        "body": "ToolUsequeryTwinAsk the AI Twin questions based on user's expertiseaddKnowledgeTeach the Twin new knowledgegetTrendsFetch trending topics scored by relevance"
      },
      {
        "title": "Brand Guide & Voice",
        "body": "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)"
      },
      {
        "title": "Notifications",
        "body": "ToolUsegetNotificationsList notifications (unread, by type, paginated)markNotificationReadMark one or all notifications as readgetNotificationPreferencesGet notification channel preferences"
      },
      {
        "title": "Account",
        "body": "ToolUselistAccountsConnected social accounts + content languagesgetCreditsCredit balance, plan, cost tablegetAnalyticsPost stats and workspace analytics"
      },
      {
        "title": "Common Workflows",
        "body": "For detailed tool schemas and workflow examples, read references/workflows.md."
      },
      {
        "title": "Quick: Create and publish a post",
        "body": "1. twinfold.createPost { topic, platforms, language, autoAdapt: true, autoPublish: true }\n\nOne call does it all — generates content, adapts per platform, publishes."
      },
      {
        "title": "Quick: Create, review, then publish",
        "body": "1. twinfold.createPost { topic, platforms, language }  → postId\n2. Show content to user, let them edit\n3. twinfold.updatePost { postId, content: editedContent }\n4. twinfold.publishNow { postId }"
      },
      {
        "title": "Full pipeline with images and hooks",
        "body": "1. twinfold.generateHooks { topic }  → pick best hook\n2. twinfold.createPost { topic, platforms, language, generateImage: true, generateFirstComment: true }  → postId\n3. twinfold.getPost { postId }  → review\n4. twinfold.publishNow { postId }"
      },
      {
        "title": "Platforms",
        "body": "LinkedIn · Twitter/X · Instagram · Facebook · YouTube · TikTok · Pinterest · Threads · Reddit · Bluesky"
      },
      {
        "title": "Languages",
        "body": "English · French · Quebec French (fr-CA) · Spanish · German · Portuguese · Brazilian Portuguese · Italian · Dutch · Japanese · Korean · Chinese · Arabic\n\nSet language per social account or per API call. Content generates natively (not translated)."
      },
      {
        "title": "Credit Costs",
        "body": "OperationCreditsPost10Article50Hook simulation5Image10First comment2Twin query2Brand guide generate5Brand voice generate5\n\nAlways check twinfold.getCredits before heavy operations."
      },
      {
        "title": "Error Handling",
        "body": "401 → Invalid API key\n402 → Insufficient credits (check with getCredits)\n400 → Bad arguments (error message explains what's wrong)\n429 → Rate limited (wait and retry)"
      },
      {
        "title": "Tips",
        "body": "Use autoAdapt: true on createPost to get platform-optimized versions automatically\nSet language: \"fr-CA\" for authentic Quebec French content\nUse getTrends → createPost for trend-jacking workflows\nrepurposeContent turns blog posts, transcripts, or notes into social posts\nplanContent creates a full week of drafts in one call\nAutopilot runs daily — use getAutopilotQueue + approvePost for review workflows"
      }
    ],
    "body": "Twinfold Skill\n\nControl Twinfold — the AI thought leadership platform — via its MCP API.\n\nSetup\n\nThe user needs a Twinfold API key. Check env var TWINFOLD_API_KEY.\n\nIf missing, tell the user:\n\nGo to twinfold.app → Settings → API Keys\nCreate a key (starts with twf_)\nSet it: export TWINFOLD_API_KEY=twf_... or add to .env\nAPI\n\nEndpoint: POST https://twinfold.app/api/mcp/tools\nAuth: Authorization: Bearer <TWINFOLD_API_KEY>\nBody: { \"tool\": \"twinfold.<toolName>\", \"arguments\": { ... } }\n\nAll calls return { \"result\": { ... } } on success or { \"error\": \"...\" } on failure.\n\nDiscover tools\ncurl https://twinfold.app/api/mcp/tools\n\n\nReturns all 34 tools with schemas. No auth required.\n\nTools Quick Reference\nContent Creation\nTool\tUse\ncreatePost\tGenerate a post with AI. Supports multilingual, images, first comments, per-platform adaptation, auto-publish\ncreateArticle\tGenerate long-form articles with Twin knowledge\nadaptContent\tRewrite content for a specific platform's culture and format\ngenerateHooks\tGet 4 viral hook options with engagement scores\ngenerateImage\tGenerate an AI image and attach to a post\nrepurposeContent\tTurn any text into multi-platform draft posts\nplanContent\tGenerate a multi-day content calendar with draft posts\nContent Management\nTool\tUse\ngetPost\tRead a single post with full details\nlistPosts\tList posts (filter by status/platform)\nupdatePost\tEdit content, platforms, media, schedule\ndeletePost\tRemove draft/scheduled posts\nlistArticles\tList articles\nPublishing\nTool\tUse\npublishNow\tPublish immediately to connected platforms\nschedulePost\tSchedule for a future date/time\nAutopilot\nTool\tUse\nrunAutopilot\tTrigger full autopilot pipeline (discover → create → publish)\ngetAutopilotQueue\tList posts pending review\napprovePost\tApprove for scheduled publication\nrejectPost\tReject an autopilot post\nIntelligence\nTool\tUse\nqueryTwin\tAsk the AI Twin questions based on user's expertise\naddKnowledge\tTeach the Twin new knowledge\ngetTrends\tFetch trending topics scored by relevance\nBrand Guide & Voice\nTool\tUse\ngetBrandGuide\tGet the brand guide markdown\nsetBrandGuide\tUpdate brand guide (free, no credits)\ngenerateBrandGuide\tAI-generate brand guide from Twin knowledge (5 credits)\nlistBrandVoices\tList all brand voice profiles\ncreateBrandVoice\tCreate a brand voice manually\nupdateBrandVoice\tUpdate an existing brand voice\ndeleteBrandVoice\tDelete a brand voice\ngenerateBrandVoice\tAI-generate a brand voice analysis (5 credits)\nNotifications\nTool\tUse\ngetNotifications\tList notifications (unread, by type, paginated)\nmarkNotificationRead\tMark one or all notifications as read\ngetNotificationPreferences\tGet notification channel preferences\nAccount\nTool\tUse\nlistAccounts\tConnected social accounts + content languages\ngetCredits\tCredit balance, plan, cost table\ngetAnalytics\tPost stats and workspace analytics\nCommon Workflows\n\nFor detailed tool schemas and workflow examples, read references/workflows.md.\n\nQuick: Create and publish a post\n1. twinfold.createPost { topic, platforms, language, autoAdapt: true, autoPublish: true }\n\n\nOne call does it all — generates content, adapts per platform, publishes.\n\nQuick: Create, review, then publish\n1. twinfold.createPost { topic, platforms, language }  → postId\n2. Show content to user, let them edit\n3. twinfold.updatePost { postId, content: editedContent }\n4. twinfold.publishNow { postId }\n\nFull pipeline with images and hooks\n1. twinfold.generateHooks { topic }  → pick best hook\n2. twinfold.createPost { topic, platforms, language, generateImage: true, generateFirstComment: true }  → postId\n3. twinfold.getPost { postId }  → review\n4. twinfold.publishNow { postId }\n\nPlatforms\n\nLinkedIn · Twitter/X · Instagram · Facebook · YouTube · TikTok · Pinterest · Threads · Reddit · Bluesky\n\nLanguages\n\nEnglish · French · Quebec French (fr-CA) · Spanish · German · Portuguese · Brazilian Portuguese · Italian · Dutch · Japanese · Korean · Chinese · Arabic\n\nSet language per social account or per API call. Content generates natively (not translated).\n\nCredit Costs\nOperation\tCredits\nPost\t10\nArticle\t50\nHook simulation\t5\nImage\t10\nFirst comment\t2\nTwin query\t2\nBrand guide generate\t5\nBrand voice generate\t5\n\nAlways check twinfold.getCredits before heavy operations.\n\nError Handling\n401 → Invalid API key\n402 → Insufficient credits (check with getCredits)\n400 → Bad arguments (error message explains what's wrong)\n429 → Rate limited (wait and retry)\nTips\nUse autoAdapt: true on createPost to get platform-optimized versions automatically\nSet language: \"fr-CA\" for authentic Quebec French content\nUse getTrends → createPost for trend-jacking workflows\nrepurposeContent turns blog posts, transcripts, or notes into social posts\nplanContent creates a full week of drafts in one call\nAutopilot runs daily — use getAutopilotQueue + approvePost for review workflows"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/lpbaril/twinfold",
    "publisherUrl": "https://clawhub.ai/lpbaril/twinfold",
    "owner": "lpbaril",
    "version": "1.0.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}