Social Skills — Automação de Redes Sociais via Browser
vanities/social-skills
Automação social sem APIs: markdown skills + Chrome real + agent-browser
Ver no GitHubSkill de automação multiplataforma (Instagram, LinkedIn, X, Pinterest, TikTok) que funciona através de um navegador Chrome real, sem APIs oficiais. Usa Claude Code OAuth-autenticado + agent-browser, com workflows markdown + bash, ideal para rotinas de publicação e gerenciamento de conteúdo social.
Instalação
npx convez-ai vanities/social-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Publicar conteúdo automatizado em múltiplas redes sociais via cron
- Gerenciar múltiplas contas de marca com persistência de sessão
- Orquestrar fluxos de conteúdo (fan-out diário) via skills compostas
Veredito

Solução técnica robusta para quem rejeita APIs oficiais e precisa de automação browser-native em redes sociais. Exige setup local avançado (macOS, Claude Code CLI, agent-browser) e credenciais diretas, mas oferece controle total sem limitações de rate-limit de API. Bem documentada, com suporte a workflows cron compostos.
README
A tradução para o português deste README ainda está na fila.
social-skills
because I'm terrible at being social.
Skill-driven social media automation. The agent (Claude Code today, OAuth-authed) does the work; this repo provides the playbook.
┌────────────────────────────────────────────────────────────┐
│ Trigger: cron / interactive slash command │
│ │ │
│ ▼ │
│ Skill (skills/<name>/SKILL.md; .claude/skills symlink) │
│ │ reads platform docs (docs/platforms/*.md) │
│ ▼ │
│ Agent (Claude Code, OAuth-authed — no API key) │
│ │ drives │
│ ▼ │
│ agent-browser CLI → real Chrome (persistent profile) │
│ ▼ │
│ Instagram / LinkedIn / X / Pinterest │
└────────────────────────────────────────────────────────────┘
Hard rules (set during the build, do not relitigate):
- No platform APIs (no Meta Graph, no X API, no instagrapi). Everything goes through a real browser.
- No Python framework. Just markdown skills + small bash scripts.
- No
ANTHROPIC_API_KEY. Claude Code (OAuth via your subscription) IS the agent. - Real Chrome only — Chrome for Testing crashes on routine UI like the profile picker.
- One persistent shared browser. Each platform = one tab. Skills find existing tabs and switch into them; they never close them.
Prerequisites
- macOS (iOS-simulator screenshots use
xcrun simctl) - Claude Code CLI, OAuth-authed
agent-browserCLI onPATHjqandImageMagick(brew install jq imagemagick)
Setup
# 1. Clone + cd in
git clone <your-fork-of-social-skills>
cd social-skills
# 2. Add credentials (only the platforms you'll use)
cp .env.example .env
# Edit .env: INSTAGRAM_*_USERNAME / _PASSWORD, LINKEDIN_*, TWITTER_*, PINTEREST_*
# 3. Configure your brand — handles, company id, topic filters
cp config/brand.example.json config/brand.json
# Edit brand.json. See PERSONAL.md for the multi-brand pattern.
# 4. Launch the persistent shared browser
bash scripts/launch_browser.sh
# 5. Log in to each platform once (state persists)
claude # then in chat: /instagram-login <account>, /linkedin-login, /x-login, /pinterest-login
That's it. Skills do the rest. For composite cron-driven skills (like a daily-content fan-out), see PERSONAL.md — those are templated in personal.example/ and copied per brand.
Skills
Login + post
| Skill | Status |
|---|---|
/instagram-login <account> · /instagram-post <account> <media...> <caption> | ✅ |
/linkedin-login · /linkedin-post <personal|<company-id>> <media...> <caption> | ✅ Personal feed or company-page. Multi-image carousels supported. |
/x-login · /x-post <handle> <thread-json> | ✅ Single tweet or multi-tweet reply chain (X's in-modal threads don't accept programmatic uploads to the 2nd+ tweet). Handle is REQUIRED — switches the X session before composing. |
/pinterest-login · /pinterest-post <pin-json> | ✅ Tall iPhone screenshots fit Pinterest natively (no padding). Creates boards inline. |
/tiktok-post | 🚫 Deferred — TikTok web upload is video-only (Photo Mode is mobile-app exclusive). See skills/tiktok-post/SKILL.md for unblock paths. |
Composite + orchestration
| Skill | What it does |
|---|---|
/feature-post <description> [brand-slug] [platforms] | End-to-end feature launch. Drives the iOS sim via XcodeBuildMCP, captures screenshots, pads, drafts platform-specific captions (announcement-style for LinkedIn / IG / X; search-rewritten how-to for Pinterest), gets your approval, then cross-posts to enabled platforms. Reads handles + brand voice from config/brand.json. |
| Daily-content composite | A cron-driven daily fan-out skill is templated in personal.example/skills/post-daily-content/ — copy to skills/post-daily-<brand>/ (gitignored; visible to Claude through .claude/skills) and customize. See PERSONAL.md. |
Engagement / warming
Pure-broadcast accounts get throttled. These skills mimic organic behavior — scroll, like, save, repost — to graduate fresh accounts and keep reach healthy.
| Skill | What it does |
|---|---|
/x-warm [brand] | Scroll feed + 1–3 likes + maybe 1 repost. Filters likes via topic_filter_regex from brand.json so the warming stays on-brand. |
/pinterest-warm [brand] | Scroll feed + 1–4 saves + 1–2 reacts + maybe 1 follow. Same topic filter as X. |
/instagram-warm [brand] | Scroll feed + 1–3 likes. No follow / comment — IG punishes those signals hardest. |
/warm-all | Picks the most-stale eligible platform per invocation and runs its warm skill (using default_brand). Cron-fired 3× daily at staggered minutes. |
Hard rules baked into every warm skill:
- No auto-comments anywhere — highest bot-detection signal.
- No auto-follow on X / IG for fresh accounts; Pinterest follow is allowed but rare.
- All actions wait
4–18sjitter between each, refs are re-snapshotted before every click.
Daily action budgets, weights, and time windows live in config/engagement-schedule.json. Per-platform state (last run, today's counters) in ~/.social-skills/state/engagement-state.json.
Cron — installed automation
# Daily content fan-out: noon local, posts to your enabled platforms.
# scripts/daily_content.sh is templated in personal.example/scripts/ — copy
# it (it's gitignored) and tailor for your brand. See PERSONAL.md.
0 12 * * * /bin/bash <repo>/scripts/daily_content.sh
# Engagement warming: 3 staggered slots, picks one platform per fire
17 9 * * * /bin/bash <repo>/scripts/warm_all_cron.sh
43 13 * * * /bin/bash <repo>/scripts/warm_all_cron.sh
22 18 * * * /bin/bash <repo>/scripts/warm_all_cron.sh
Both wrappers invoke claude --print --dangerously-skip-permissions "/<skill>" because cron can't approve interactive permission prompts.
Operational caveats:
- The Mac must be awake at fire times (cron doesn't wake the machine).
- The persistent Chrome window must be open with all platform tabs logged in. Run
bash scripts/launch_browser.shafter a reboot.
Helper scripts
| Script | What |
|---|---|
scripts/launch_browser.sh | Boots the persistent shared Chrome against ~/.social-skills/chrome-profile/ with the anti-detection flag. |
scripts/jitter.sh MIN MAX | Random delay generator — used between every browser action. |
scripts/pad_ios_screenshot.sh <input> [output] [mode] | Pads tall iPhone screenshots to 4:5. Plain modes: edge (seamless sample), blur (Apple-style frame), random (palette), #RRGGBB (solid). Fancy modes include gradient, bloom, sparkle, cosmic, divine, holy, lovely, mother, father, dream, ascii-art, shadow, lament, easter, christmas, pentecost. Smart: surprise picks a lighter fancy mode at random. |
scripts/ascii_devotional_video.sh <screenshot.png> [output.mp4] [theme] [reference] | Builds a short 9:16 h264 MP4 with animated ASCII-video-style background behind a devotional screenshot. Pair with pad_ios_screenshot.sh ... ascii-art for the static ASCII-art-style image route. |
scripts/warm_all_cron.sh | Warming cron entrypoint — cd into the repo, restore PATH, guard the shared Chrome's health, run Claude headless. |
scripts/daily_content.sh | Daily-content cron entrypoint (template in personal.example/scripts/, gitignored once installed). Same guard pattern, calls your composite skill. |
Logs
| Log | Source |
|---|---|
~/.social-skills/logs/cron/<date>.log | Daily content cron (shell + headless Claude stdout) |
~/.social-skills/logs/cron/warm-<date>.log | Warm cron |
~/.social-skills/logs/login/<platform>-<account>-<ts>.json | Per-login form-field discovery (the breadcrumb that makes UI changes easy to chase) |
~/.social-skills/logs/post/<platform>-<account>-<ts>.json | Per-post outcome + verification screenshot path |
~/.social-skills/logs/warm/<platform>-<account>-<ts>.json | Per-warm-pass actions executed |
~/.config/agent-browser/<platform>-<account>.json | Saved browser session (cookies, localStorage, etc.) |
Layout
social-skills/
├── README.md
├── AGENTS.md ← universal agent playbook (PII-free)
├── CLAUDE.md -> AGENTS.md ← Claude Code compatibility symlink
├── CLAUDE.local.md.example ← Claude Code personal addendum template (handles, live state, voice)
├── PERSONAL.md ← how the personal/.example pattern works
├── .env.example
├── config/
│ ├── brand.example.json ← multi-brand schema (handles, IDs, topic filters)
│ ├── engagement-schedule.json ← warming cadence (active hours, daily budgets, weights)
│ └── comment-corpus.json ← universal warm-comment phrases (curate per brand)
├── docs/
│ ├── architecture.md
│ └── platforms/<name>.md ← reusable per-platform playbooks
├── scripts/
│ ├── launch_browser.sh
│ ├── jitter.sh
│ ├── pad_ios_screenshot.sh
│ ├── ascii_devotional_video.sh
│ ├── pad_ios_video.sh
│ ├── type_human.sh
│ ├── x_switch_account.sh
│ ├── find_platform_tab.sh
│ ├── switch_to_platform_tab.sh
│ └── warm_all_cron.sh
├── skills/ ← universal skill source of truth
│ ├── instagram-{login,post,warm}/SKILL.md
│ ├── linkedin-{login,post}/SKILL.md
│ ├── x-{login,post,warm,article}/SKILL.md
│ ├── pinterest-{login,post,warm}/SKILL.md
│ ├── reddit-post/SKILL.md ← stub
│ ├── tiktok-post/SKILL.md ← stub, deferred
│ ├── feature-post/SKILL.md
│ └── warm-all/SKILL.md
├── .claude/
│ └── skills -> ../skills ← Claude Code compatibility symlink
└── personal.example/ ← templates for brand-flavored composite skills
├── README.md
├── comment-corpus.brand.json ← sample domain-specific comment phrases
├── scripts/
│ ├── daily_content.sh ← sample cron entrypoint
│ └── devotional_video*.sh ← sample brand-specific helpers
└── skills/
└── post-daily-content/SKILL.md
Adding a platform
- Write
docs/platforms/<name>.md— URLs, login flow, anti-bot notes. - Add skills
skills/<name>-login/SKILL.md,<name>-post/SKILL.md, optionally<name>-warm/SKILL.md. Claude Code sees them through.claude/skills -> ../skills. Mirror thex-*skills as a template — they cover the trickiest cases (graduated-access, reply-chain threads, viewport-required clicks). - Update
config/engagement-schedule.jsonwith the platform's action budget. - Wire into
/warm-alland your daily-content composite (inskills/post-daily-<brand>/) if you want it cron-scheduled.
Status
- Instagram — login, post (incl. multi-image carousel), warm
- LinkedIn — login (incl. PIN checkpoint), post (personal + company pages)
- X / Twitter — login, post (incl. reply-chain threads), warm
- Pinterest — login, post (incl. inline board creation), warm
- Daily-content composite — sample skill in
personal.example/, fans to IG + X + Pinterest, cron-driven -
/feature-post— XcodeBuildMCP-driven multi-platform feature launch - Engagement warming —
/warm-allcron with 3 staggered slots, per-platform action budgets - iOS screenshot padding —
edge/blur/random/ hex modes - TikTok — deferred until a video pipeline exists (animated screenshots + voiceover)
- YouTube Shorts — same blocker as TikTok
- Facebook Page — easiest path is creating a Page + linking to IG via Meta Accounts Center to enable the cross-post toggle
- Bluesky — similar to X minus the friction; ~1 hr to mirror the X skills
- Auto-comment generation with user-approval pattern (currently fully skipped — too high-risk)