RonShih/social-media-bot

weekly-plan-research

Per-platform top-post analysis of competitor products via fetch-reference (public).

weekly-plan-draft

Generate caption + hashtags + media plan + product_id for one schedule slot. Subagent-friendly: orchestrator spawns one per slot in parallel.

weekly-plan-export

Convert plan.json into plan.xlsx via scripts/plan-export.mjs (exceljs).

weekly-plan-schedule

Compute per-platform posting frequency and best-time slots for the week. Outputs a schedule grid the draft step fills in.

delete-facebook

Delete a Facebook post by its public URL. Used by /test-roundtrip cleanup.

delete-instagram

Delete an Instagram Feed post or Reel by URL.

delete-threads

Delete a Threads post by URL.

delete-tiktok

Delete a TikTok video via Studio.

delete-x

Delete an X (Twitter) post by URL.

delete-youtube

Move a YouTube video to trash via Studio. Soft delete — the video is recoverable for 30 days.

draft-facebook

Draft a Facebook caption + hashtags. Medium length, link-friendly, low hashtag density.

draft-instagram

Draft an Instagram Feed caption + hashtags. Visual-first, dense hashtags, the first line decides scroll-stop.

draft-threads

Draft a Threads post. 500-char native voice, conversational, minimal hashtags.

draft-tiktok

Draft a TikTok caption + hashtags. First 3 seconds hook lives in the video; caption is short with trend-aware tags.

draft-x

Draft a single X (Twitter) post. 280-char hard cap including hashtags. Hook is everything.

draft-youtube

Draft a YouTube video title + description + tags. SEO-leaning. Title is the traffic lever.

fetch-reference

Pull the main content (title / body / key images) of an external URL for draft-* skills. Multi-layer fallback against bot blockers.

image-generator

Pick from the brand asset library or generate a new image for a post. Returns a relative path under media/assets/<brand>/.

local-reader

Resolve local asset paths and list the brand asset library. Used by publish-* and weekly-plan-* before they touch files.

local-writer

Save a generated or uploaded asset (image / video) into media/assets/<brand>/.

publish-facebook

Publish a Facebook post (image or video / Reel) via Playwright. Reads brand from active YAML.

publish-instagram

Publish an Instagram Feed post (image or Reel) via Playwright. Reads brand from active YAML.

publish-threads

Publish a Threads post (text, image, or video) via Playwright. Threads identity = Instagram identity.

publish-tiktok

Upload a short video to TikTok via TikTok Studio. Video-only.

publish-x

Publish a single X (Twitter) post — text + optional image or video — via Playwright.

publish-youtube

Upload a video to YouTube via Studio and fill metadata. Video-only.

test-roundtrip

Validate a publish flow end-to-end. Two modes — dry-run (stop before final Publish) or roundtrip (real publish + delete + verify).

video-helper

Probe a video file (duration, aspect ratio, codec) via ffprobe. Used by publish-* video flows for sanity checks.

weekly-plan-review

Re-visit posted URLs from the previous week's plan and scrape current likes / reach into the Metrics sheet.