claude-socials
A collection of skills for posting content to social media platforms — directly from your terminal or AI-assisted workflows. Supports Claude Code, OpenAI Codex, and Hermes Agent (Nous Research).
Browser-based skills use Playwright MCP for automation. The Threads skills post the content you provide through an automated browser session, so you can approve the draft and let the agent publish it without setting up Meta Graph API credentials.
Available Plugins
More platforms coming soon (Reddit, LinkedIn, Twitter/X, Lobsters, ...).
Supported Agents
Install
One-liner (auto-detects Claude Code, Codex, and Hermes)
curl -fsSL https://raw.githubusercontent.com/adityak74/claude-socials/main/scripts/install.sh | sh -s -- hn-submit
curl -fsSL https://raw.githubusercontent.com/adityak74/claude-socials/main/scripts/install.sh | sh -s -- threads-post
curl -fsSL https://raw.githubusercontent.com/adityak74/claude-socials/main/scripts/install.sh | sh -s -- substack-post
The installer detects whichever of claude, codex, and hermes are on your $PATH and installs into each. Override with --agent <claude|codex|hermes|all>:
# Install only into Codex
curl -fsSL https://raw.githubusercontent.com/adityak74/claude-socials/main/scripts/install.sh | sh -s -- hn-submit --agent codex
# Install into all agents explicitly
curl -fsSL https://raw.githubusercontent.com/adityak74/claude-socials/main/scripts/install.sh | sh -s -- threads-post --agent all
After installing, restart your agent to activate the skills.
Claude Code (manual)
Inside Claude Code:
/plugin marketplace add adityak74/claude-socials
/plugin install hn-submit@claude-socials
/plugin install threads-post@claude-socials
/plugin install substack-post@claude-socials
Or from the terminal:
claude plugin marketplace add adityak74/claude-socials
claude plugin install hn-submit@claude-socials
# Project scope — shared with your team via .claude/settings.json
claude plugin install threads-post@claude-socials --scope project
Prerequisites
Plugins use Playwright MCP for browser automation. For Threads, the agent posts the given content through the Threads web UI after you approve the draft.
Playwright MCP
1. Install Playwright browsers
npx playwright install
2. Configure Playwright MCP in Claude Code
Add to your MCP config globally (~/.claude/claude_desktop_config.json) or per-project (.mcp.json):
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
See the Playwright MCP repo for full options (headed/headless mode, browser choice, auth persistence).
3. Log in to Threads in the Playwright browser
The Threads skills use your browser session instead of API tokens. On first use, the agent will open https://www.threads.net/; log in once in that browser profile, then future posts can reuse the session when your Playwright setup preserves browser state.
Usage
Once a plugin is installed, trigger it with natural language or the skill command.
Hacker News
/hn-submit
Or just describe what you want:
Post this to HN
Submit to Hacker News — title: "My Article", URL: https://example.com/my-article
Share on HN
The agent handles login (via credentials) and submission automatically.
Threads
The threads-post plugin includes four skills — Claude picks the right one based on what you describe:
| Skill | Trigger |
|---|
threads-post | "post this to Threads", "share on Threads" |
threads-post-carousel | "carousel on Threads", "post multiple images to Threads" |
threads-post-thread | "create a thread", "thread this article" |
threads-post-spoiler | "spoiler post on Threads", "hide this behind a spoiler" |
/threads-post
/threads-post-carousel
/threads-post-thread
/threads-post-spoiler
Or describe what you want:
Post this article to Threads
Create a thread chain from this blog post
Share these 5 images as a carousel on Threads
Post this plot twist as a spoiler
obra
affaan-m
anthropics
sickn33
ChromeDevTools