social-handoff
Skill1 starsChanged 14 days agoMITView on GitHub
Use when the user wants to post, schedule, run a social campaign, work their social Inbox, read social analytics, or manage connected social accounts. Triggers on "post", "schedule", "campaign", "tweet", "publish to Instagram/TikTok/Threads/Facebook/LinkedIn/X/Pinterest/Reddit/Bluesky/YouTube Shorts/Google Business/Discord", "social media", "my queue", "my inbox", "best time to post". Everything runs on the StorytellerOS connector's stos_social_* tools; no second connector is needed.
In this repository29 other files it gives its agents.
- ads-studioSkill
- blog-post-and-newsletterSkill
- calendarSkill
- chapter-draftingSkill
- character-mergeSkill
- financeSkill
- getting-startedSkill
- manuscript-importSkill
- manuscript-revisionsSkill
- markersSkill
- marketing-studioSkill
- mentionsSkill
- pen-namesSkill
- quick-task-captureSkill
- sales-studioSkill
- story-bibleSkill
- stos-setupSkill
- tasksSkill
- timelineSkill
- time-trackingSkill
- wordpress-connectSkill
- wordpress-llm-optimizationSkill
- wordpress-mediaSkill
- wordpress-pagesSkill
- wordpress-postsSkill
- wordpress-productsSkill
- wordpress-seoSkill
- worldbuilding-mergeSkill
- worldbuildingSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 35
Look up what the post is about before drafting: stos_titles_get, stos_title_variations_list (ASINs and formats live on the variation), …
- Very specific: line 81
Calling internal app endpoints: instead of the stos_social_* tools.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Social Studio from Claude
The rule
All social work runs through the StorytellerOS connector. The stos_social_*
tools cover posting, scheduling, campaigns, the Inbox, analytics and account
settings. Do not look for, suggest, or wait for a second social connector or
plugin. If a stos_social_* tool is missing, the StorytellerOS connector is not
connected or not enabled: route to stos-setup.
1. Scope to the pen name first
stos_pen_names_list() // match the pen name the user means
stos_social_accounts_list({ penNameId }) // what is connected under itPass penNameId on every social call in the flow. Without it the call targets
the active pen name, which may not be the one the user meant.
- A refusal that says social posting isn't set up for the pen name: stop and tell the user to set it up in StorytellerOS (Settings, then Pen Name Details). Don't retry under another pen name.
- An account that needs reconnecting (
stos_social_accounts_health): say which one and point the user to Social Studio accounts in the app. Connecting a new social account also happens in the app.
2. Pull the writing context from StorytellerOS
Look up what the post is about before drafting: stos_titles_get,
stos_title_variations_list (ASINs and formats live on the variation),
stos_pen_names_get (voice, guides, tagline), stos_social_guides_get. Write in
the pen name's voice.
3. Pick the tool
| User intent | Tool |
| Post now, schedule, draft or queue a post | stos_social_posts_validate first, then stos_social_posts_create |
| Upload media for a post | stos_social_media_upload_url (PUT the bytes, reuse publicUrl) or a Media Studio asset (stos_media_assets_list) |
| Check a caption or file before posting | stos_social_validate (post-length, media, subreddit, full dry run), stos_social_hashtags_check |
| Change, retry, archive, unpublish a post | stos_social_posts_update, _retry, _archive, _unpublish; swap media with stos_social_posts_media_edit |
| Copy a post | stos_social_posts_duplicate |
| What's in my queue? | stos_social_queues_list, stos_social_queues_preview, stos_social_queues_next |
| Launch campaign for a title | the campaign flow below |
| Labels, calendar notes, archive | stos_social_labels, stos_social_post_labels, stos_social_calendar_notes, stos_social_archived_posts |
| DMs, comments, reviews | stos_social_inbox_* (list, reply, private reply, like, hide, pin, react) |
| Comment-to-DM and Inbox flows | stos_social_comment_automations_*, stos_social_inbox_flows_* |
| How did my posts do? When should I post? | stos_social_analytics (report: posts, best-time, follower-stats, ...) |
| Platform options (boards, subreddits, flairs, playlists, TikTok privacy) | stos_social_account_options |
| Account settings (defaults, Facebook Page, LinkedIn identity, Discord, Messenger menu, ice breakers, groups) | stos_social_account_update, stos_social_account_messaging_settings, stos_social_account_groups |
| RSS auto-drafting | stos_social_rss_feeds |
| Find something to post | stos_social_find_content, stos_social_reddit, stos_social_youtube_transcript |
| Ads (boost a post, run ads) | the ads-studio skill |
4. Campaign flow (a launch, a month of posts)
stos_social_campaigns_createwith the title, pen name and objective.stos_social_campaign_sample_generate: one look-check image. Show it; approve the look (stos_social_campaigns_update) before going on.stos_social_campaign_plan_generate: generate the plan, or save a reviewed one.stos_social_campaign_captions_generate, thenstos_social_campaign_media_generateand pollstos_social_campaign_media_status. Overlays:stos_social_campaign_text_overlays_apply; a carousel as one video:stos_social_campaign_carousel_video.- Review with the user, then
stos_social_campaign_schedule. Each platform's queue sets the timing. Relay the returned warnings.
Anti-patterns
- Publishing without review. Show the account, the content and the time, and get a yes before anything goes live.
- Forgetting
penNameIdin a multi-step flow. - Telling the user to install another connector for social work. The StorytellerOS connector covers it.
- Calling internal app endpoints instead of the
stos_social_*tools.
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.