social-skills

Capture today's content from an iOS simulator (or any source you wire up), draft platform-tailored captions, and fan out to your enabled platforms. Sample composite that's intended to be copied + edited per brand. Use when the user says "post today's content", "publish daily", or runs /post-daily-content.

Post a media file to Instagram with a caption. Operates against the shared headed Chrome — finds the existing Instagram tab if one is open, otherwise opens one. Use when the user says "post X to Instagram" or runs /instagram-post.

Post a pin to Pinterest. Reads a JSON spec with media, title, description, board, and optional destination link. Use when the user says "post to pinterest", "pin this", or runs /pinterest-post.

Orchestrate a cross-platform launch post for an iOS app feature. Drives the iOS simulator to capture screenshots / video, pads them, drafts platform-tailored captions (announcement-style for LinkedIn / IG / X; search-rewritten how-to for Pinterest), gets user approval, then cross-posts to enabled platforms. First arg is the feature description; second is optional brand slug; third is comma-separated platforms (default all). Use when the user says "feature post X", "post about the new Y feature", or runs /feature-post.

Log into an Instagram account in the shared headed Chrome. If .env has INSTAGRAM_<ACCOUNT>_USERNAME / _PASSWORD set, signs in automatically; otherwise pauses for manual sign-in. Always logs the form fields it found so we can detect IG UI changes. Use when the user says "log in to instagram" or runs /instagram-login.

Run a single warming pass on Instagram — scroll the home feed, like 1-3 posts. First arg is an optional brand slug (defaults to default_brand in config/brand.json). Reads cadence from config/engagement-schedule.json, brand tunables (own handle, topic regex) from config/brand.json. Use when the user says "warm instagram", "engage on ig", or runs /instagram-warm. Also called by /warm-all on a schedule.

Log into LinkedIn in the shared headed Chrome. Auto-mode if .env has LINKEDIN_USERNAME / LINKEDIN_PASSWORD set; pauses for any verification PIN that LinkedIn requires on a new device fingerprint. Logs the form refs found. Use when the user says "log into linkedin" or runs /linkedin-login.

Post a media + caption to LinkedIn. Pass `personal` to post to your own feed, or a numeric company id to post AS that company page (find your id in the page admin URL). Use when the user says "post X to linkedin" or runs /linkedin-post.

Log into Pinterest in the shared headed Chrome. Auto-mode if .env has PINTEREST_USERNAME / PINTEREST_PASSWORD set; pauses for any verification challenge Pinterest throws on a new device. Logs the form refs found. Use when the user says "log into pinterest" or runs /pinterest-login.

Run a single warming pass on Pinterest — scroll the home feed, save 1-3 pins, react (heart) on 1-2, optionally follow one creator. First arg is an optional brand slug (defaults to default_brand in config/brand.json). Reads cadence from config/engagement-schedule.json, brand tunables (own handle, topic regex, parody-risk handles) from config/brand.json. Use when the user says "warm pinterest", "engage on pinterest", or runs /pinterest-warm. Also called by /warm-all on a schedule.

Post to a single subreddit. STUB — Reddit fundamentally breaks the cross-post / cron / warm patterns the other skills assume; this file documents why and what shape the skill should take when actually used. Read it before attempting anything Reddit-related. Use when the user says "post to reddit", "submit to r/<sub>", or runs /reddit-post.

Post to TikTok. CURRENTLY DEFERRED — TikTok's web upload is video-only; Photo Mode (image carousels) is mobile-app exclusive. This skill documents the state and the three paths forward. Read it before attempting anything TikTok-related.

Log into X (Twitter) in the shared headed Chrome. Auto-mode if .env has TWITTER_USERNAME / TWITTER_PASSWORD set; pauses for any verification challenge X throws on a new device fingerprint. Logs the form refs found. Use when the user says "log into x" / "log into twitter" or runs /x-login.

Post a tweet or a multi-tweet thread on X (Twitter) from a specific account. First arg is the X handle (no `@`); second is a path to a JSON file describing the tweets. Each entry has `text` (≤280 chars) and optional `media` (1–4 image paths). Use when the user says "post to X", "tweet this", or runs /x-post.

Run a single warming pass on X — scroll the home feed, like 1-3 tweets, optionally repost one. First arg is an optional brand slug (defaults to default_brand in config/brand.json). Reads cadence from config/engagement-schedule.json, brand tunables (own handle, topic regex, parody-risk handles) from config/brand.json, and respects the daily budget + min-gap stored in ~/.social-skills/state/engagement-state.json. Use when the user says "warm x", "engage on x", or runs /x-warm. Also called by /warm-all on a schedule.

Pick the most-stale enabled platform (by last_run_iso) and run its warm skill once. Designed to be invoked by cron 2-3 times daily; each call advances rotation. Respects per-platform daily caps and the global min-gap. Use when the user says "warm all", "engagement run", or runs /warm-all.

Draft a long-form X Article (formatted essay with headings, bold, lists, images) and write it to articles/<slug>.md as a paste-ready file. Does NOT auto-publish — the X composer's rich-text editor races with keyboard typing on markdown shortcuts and contextually hides toolbar buttons, so reliable auto-fill is impractical. The user pastes paragraph-by-paragraph into x.com/compose/articles, applying the toolbar buttons by hand. Use when the user says "draft an X article", "write a long-form post for X", or runs /x-article.