connect-social-accounts
Skill2 starsChanged 20 days agoMITView on GitHub
Connect Instagram, TikTok, LinkedIn, X, Threads, Bluesky, Facebook, Pinterest and YouTube accounts so the assistant can post to them through WoopSocial. Use when the user asks \"can you post to my Instagram?\", \"connect my LinkedIn\", \"link my TikTok\", \"add a new client's accounts\", or a post can't go out because no account is connected. Explains what the assistant can and can't post (not Reddit or Mastodon), creates a project per brand or client, gives a secure sign-in link and confirms the account is live.
5 other projects use a version of this.
Adopted by
Most recently taken up by
- posteverywhere/codex-plugintheir own version, first seen Nov 16, 2026
- PostPeer-API/skillstheir own version, first seen Nov 2, 2026
- posteverywhere/copilot-plugintheir own version, first seen Oct 17, 2026
- posteverywhere/cursor-plugintheir own version, first seen Oct 15, 2026
- posteverywhere/claude-plugintheir own version, first seen Sep 29, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- PostPeer-API/skills★ 77same name
- posteverywhere/claude-plugin★ 1same name
- posteverywhere/codex-plugin★ 1same name
- posteverywhere/copilot-plugin★ 0same name
- posteverywhere/cursor-plugin★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository16 other files it gives its agents.
- bulk-schedule-postsSkill
- content-calendar-generatorSkill
- content-ideas-generatorSkill
- cross-post-everywhereSkill
- fix-failed-postsSkill
- instagram-carousel-makerSkill
- instagram-postsSkill
- linkedin-postsSkill
- manage-post-queueSkill
- publish-postsSkill
- real-estate-instagram-postsSkill
- restaurant-instagram-postsSkill
- social-media-auditSkill
- social-media-reportSkill
- tiktok-postsSkill
- weekly-social-autopilotSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 11 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 5 edited versions we read keep these.
11
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
If no WoopSocial tools (projects_list, social_accounts_list and so on) are available, the connector isn't set up yet.
- Distinctive: line 16
Create a WoopSocial account: …
- Distinctive: line 20
Stop there. Don't pretend anything is connected.
- Distinctive: line 27
The assistant can: write the post, schedule it for a set time, publish it now, save it as a draft, post the same thing to several …
- Distinctive: line 34
Pick the project: Call projects_list.
- Distinctive: line 39
Check what's already there: Call social_accounts_list for the project.
- Very specific: line 40
Ask which platforms to connect,: if the user didn't say. LinkedIn: ask whether it's their personal profile (LINKEDIN) or a company page …
- Distinctive: line 47
If creating the link fails, say so in plain words and try once more.
- Distinctive: line 48
Confirm: When they say done, call social_accounts_list again and show the new account by platform and username, with status CONNECTED.
- Distinctive: line 49
Do one platform at a time: when connecting several, so a failed sign-in doesn't get lost.
- Distinctive: line 57
Only on request. Name the account (platform and username) and ask for a yes, then call social_accounts_delete.
- Distinctive: line 65
Ask for or accept a social media password, 2FA code or API key in chat.
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Connect social accounts
Get the user from "can you post for me?" to a connected, working account in a few minutes. WoopSocial does the posting. The assistant never sees or stores social media passwords.
The user's explicit instructions take priority over these guidelines, except that you never post, delete or change posts beyond what the user asked for.
Step 0: Is WoopSocial available here?
If no WoopSocial tools (projects_list, social_accounts_list and so on) are available, the connector isn't set up yet. Tell the user:
- Create a WoopSocial account: https://app.woopsocial.com/signup?utm_source=claude-plugin&utm_medium=skill&utm_campaign=woop-plugin-v1&utm_content=connect-social-accounts
- Connect WoopSocial from the plugin's Connectors tab (in Claude Code, run
/mcp) and sign in. No API key is needed. - Come back and say "connect my accounts".
Stop there. Don't pretend anything is connected.
Answering "can you post to my socials?"
Answer in a few lines, then offer to connect:
- Yes, through WoopSocial: Instagram (posts, carousels, Reels, Stories, Trial Reels), TikTok (videos and photo carousels), LinkedIn (personal profile and company pages), X, Threads, Bluesky, Facebook Pages (posts, Reels, Stories), Pinterest (pins to boards) and YouTube (videos and Shorts).
- The assistant can write the post, schedule it for a set time, publish it now, save it as a draft, post the same thing to several platforms, show what's scheduled, and report results for posts sent through WoopSocial.
- Not supported: Reddit and Mastodon. Thread chains on X, Threads or Bluesky go out as single posts only. Replying to comments and DMs isn't supported.
- Uploading photos and videos needs the assistant to be able to run code or a shell (Claude Code, or claude.ai with code execution turned on). Text posts work everywhere.
- Nothing posts unless the user asks for it. When the assistant wrote or changed the post, when it's more than one post, or when the account or time is unclear, the assistant shows it first and waits for a yes.
Connect flow
- Pick the project. Call projects_list.
- None: ask what the brand or business is called, then call projects_create with that name.
- One: use it.
- Several: list them by name and ask which one, or whether this is a new brand or client (then projects_create).
- Agencies get one project per client. A single post can only go to accounts in the same project, so don't mix clients.
- Check what's already there. Call social_accounts_list for the project. Tell the user which platforms are connected and which show DISCONNECTED.
- Ask which platforms to connect, if the user didn't say. LinkedIn: ask whether it's their personal profile (LINKEDIN) or a company page (LINKEDIN_PAGES). Each is its own connection.
Create the sign-in link. For each platform, call oauth_create_authorization with the projectId and platform. Don't pass redirectUrl. If the returned URL starts with
/, puthttps://app.woopsocial.comin front of it. Give the user the link and tell them:- Open it in a browser, sign in to the platform, and approve access.
- Instagram needs a professional account (Business or Creator). If it's a personal account, the sign-in won't work until they switch it to Business or Creator in the Instagram app.
- Facebook Pages and LinkedIn company pages: if the sign-in asks which page to allow, pick the one they want to post to.
- Reply "done" when finished.
If creating the link fails, say so in plain words and try once more. If it fails again, the user can connect the account in the WoopSocial app.
- Confirm. When they say done, call social_accounts_list again and show the new account by platform and username, with status CONNECTED. If it isn't there, ask what they saw on the sign-in screen and offer a fresh link.
- Do one platform at a time when connecting several, so a failed sign-in doesn't get lost.
Reconnecting
An account with status DISCONNECTED (or a post that failed with an expired login) needs the same flow. Create a new sign-in link for that platform in the same project and confirm afterwards. Then check social_account_posts_list for that account with deliveryStatus FAILED. Posts that failed while it was disconnected are not retried automatically, so offer to re-send them.
Removing an account
Only on request. Name the account (platform and username) and ask for a yes, then call social_accounts_delete. Mention that posts still scheduled for that account may not go out.
After connecting
Offer the next useful step in one line, for example: "Want to schedule your first post? Send me the text and any image or video." Don't push further than that.
Never
- Ask for or accept a social media password, 2FA code or API key in chat. The sign-in link is the only way.
- Show internal IDs to the user.
- Say an account is connected before social_accounts_list shows it as CONNECTED.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

