threads-post

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

Plugin	Platform	Status
hn-submit	Hacker News	✅ Available
threads-post	Meta Threads	✅ Available
substack-post	Substack	✅ Available

More platforms coming soon (Reddit, LinkedIn, Twitter/X, Lobsters, ...).

---

Supported Agents

Agent	Install path
Claude Code	Plugin marketplace → plugins/
OpenAI Codex	$HOME/.agents/skills/
Hermes Agent	hermes skills tap or $HOME/.hermes/skills/

---

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