Twinfold

Create, adapt, schedule, publish, and analyze AI-generated social media content across 10 platforms in 13 languages using Twinfold's API.

Security Scan

The skill appears to implement a legitimate Twinfold API integration, but there are metadata inconsistencies and provenance gaps that warrant caution before installing or providing an API key.

Purpose & Capability

The SKILL.md describes a social-media/content-management integration with Twinfold and only asks for a Twinfold API key (prefix twf_), which is appropriate for the stated purpose. However, the registry metadata at the top of the submission claims 'Required env vars: none' and 'Primary credential: none' while the SKILL.md explicitly requires TWINFOLD_API_KEY — this mismatch is an incoherence between declared registry metadata and the actual runtime instructions.

Instruction Scope

The runtime instructions are scoped to calling the twinfold.app API (POST https://twinfold.app/api/mcp/tools) and provide curl examples and tool schemas. They only reference the TWINFOLD_API_KEY environment variable and typical post/workflow artifacts. There are no instructions to read unrelated local files, other environment variables, or to transmit data to unexpected endpoints in the SKILL.md itself (aside from example media URLs which are normal for media uploads).

Install Mechanism

This is an instruction-only skill with no install spec and no code files; nothing is written to disk and no third-party packages are fetched. That minimizes install-time risk.

Credentials

The only credential the SKILL.md requires is TWINFOLD_API_KEY, which is proportionate to a service integration. The submission-level metadata, however, contradicts this by listing no required env vars — the discrepancy should be resolved. Also note that providing the API key gives the skill the ability to create/update/publish posts and consume credits, so the key must be protected and ideally revocable/limited in scope.

Persistence & Privilege

The skill does not request always:true and is user-invocable with normal autonomous invocation allowed (platform default). It does not request system-wide config changes or persistent privileges beyond using the provided API key.

What to consider before installing

This skill looks functionally consistent with a Twinfold API integration, but take these precautions before installing: 1) Resolve the metadata mismatch — the SKILL.md requires TWINFOLD_API_KEY but the registry summary claims no env vars; ask the publisher to clarify. 2) Source and homepage are missing — verify twinfold.app is the legitimate service and that the skill is published by a trusted party before supplying credentials. 3) Use a revocable/test API key with minimal permissions and monitor account activity and credit usage (autoPublish/autopilot can spend credits and post on your accounts). 4) Review the platform's privacy/billing terms and consider creating a separate Twinfold account for integration testing. 5) If you proceed, watch network/activity logs for unexpected endpoints and revoke the key if anything suspicious occurs.

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