schedule-social-posts
Installation
SKILL.md
Schedule social posts
Use the PostEverywhere connector to turn what the user wants to say into posts on their connected accounts. Posting is public and hard to undo, so confirm before anything goes live.
Steps
- Find the accounts. Call
list_accounts. Note each account'sid, platform and health. If the user has no accounts, or none for a platform they named, use theconnect-social-accountsskill first. - Pick the targets. Use the accounts the user named. If they said "everywhere", use every healthy account. Skip an account whose health says it needs reconnecting, and tell the user which one and why.
- Check the rules. For any platform you are unsure about, call
get_platform_rulesonce and read the character limit, media rules and supported features. Common limits are inreferences/platform-limits.md. - Write the post. Write one main caption in
content. When a platform needs something different, set it inplatform_contentkeyed by platform, for example a shorter X version:{"x": {"content": "..."}}. Keep the user's voice and facts. Don't invent claims, prices, links or statistics. - Add media. For an image or video at a public URL, call
upload_media_from_urland use the returned media id inmedia_ids. Instagram and TikTok need media. YouTube needs a video. Google Business Profile takes at most one photo and no video. - Confirm first. Show the user, per account, the text, the media and the time. Unless they already said "publish now" or "schedule it" for this exact post, create it as a draft:
create_postwithdraft: true. Then ask for a go-ahead. - Publish or schedule. After the user confirms, call
schedule_postwith the draft'spost_idand eitherscheduled_for(ISO 8601, withtimezone, for example"Europe/London") orpublish_now: true. To let the user's posting queue choose the time, create the post withuse_queue: trueinstead of a time. Callget_queuefirst if they want to know which slot they'll get. - Report back. Give the post id, the accounts and the time. For "publish now", call
get_post_resultsafter a short wait and report which platforms published and any failure in plain words.
Timing
- Ask for the time zone if the user gives a time without one and their account time zone is unknown.
get_mereturns account details. - A time in the past publishes immediately. Check with the user before sending one.