AGENT SKILL

twinfold

暂无简介

License 许可
MIT
最近更新
2026-06-07
Stars
★ 0
Forks
1

03 SKILL.md 正文

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:

  1. Go to twinfold.app → Settings → API Keys
  2. Create a key (starts with twf_)
  3. 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.

Tools Quick Reference

Content Creation

Tool Use
createPost Generate a post with AI. Supports multilingual, images, first comments, per-platform adaptation, auto-publish
createArticle Generate long-form articles with Twin knowledge
adaptContent Rewrite content for a specific platform's culture and format
generateHooks Get 4 viral hook options with engagement scores
generateImage Generate an AI image and attach to a post
repurposeContent Turn any text into multi-platform draft posts
planContent Generate a multi-day content calendar with draft posts

Content Management

Tool Use
getPost Read a single post with full details
listPosts List posts (filter by status/platform)
updatePost Edit content, platforms, media, schedule
deletePost Remove draft/scheduled posts
listArticles List articles

Publishing

Tool Use
publishNow Publish immediately to connected platforms
schedulePost Schedule for a future date/time

Autopilot

Tool Use
runAutopilot Trigger full autopilot pipeline (discover → create → publish)
getAutopilotQueue List posts pending review
approvePost Approve for scheduled publication
rejectPost Reject an autopilot post

Intelligence

Tool Use
queryTwin Ask the AI Twin questions based on user's expertise
addKnowledge Teach the Twin new knowledge
getTrends Fetch trending topics scored by relevance

Brand Guide & Voice

Tool Use
getBrandGuide Get the brand guide markdown
setBrandGuide Update brand guide (free, no credits)
generateBrandGuide AI-generate brand guide from Twin knowledge (5 credits)
listBrandVoices List all brand voice profiles
createBrandVoice Create a brand voice manually
updateBrandVoice Update an existing brand voice
deleteBrandVoice Delete a brand voice
generateBrandVoice AI-generate a brand voice analysis (5 credits)

Notifications

Tool Use
getNotifications List notifications (unread, by type, paginated)
markNotificationRead Mark one or all notifications as read
getNotificationPreferences Get notification channel preferences

Account

Tool Use
listAccounts Connected social accounts + content languages
getCredits Credit balance, plan, cost table
getAnalytics Post 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

Operation Credits
Post 10
Article 50
Hook simulation 5
Image 10
First comment 2
Twin query 2
Brand guide generate 5
Brand voice generate 5

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

04 同仓库更多 Skills

javimosch
javimosch/open-claw-skills

crowd-prompting

A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.

★ 0
javimosch
javimosch/open-claw-skills

ceaser

Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).

★ 0
javimosch
javimosch/open-claw-skills

ceaser-send

Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.

★ 0
javimosch
javimosch/open-claw-skills

dilemm-ai

Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

arxiv-paper-reviews

Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.

★ 0