explaingit

cxjwin/x-post-scheduler

Analysis updated 2026-05-18

30JavaScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TLDR

A Claude Code skill that turns an article link into a scheduled X post, complete with an optional poster image and a human confirmation step before publishing.

Mindmap

mindmap
  root((x-post-scheduler))
    What it does
      Article to X post
      Poster image generation
      Long form Article publishing
      Human confirmation gate
    Tech stack
      Node.js scripts
      Buffer API
      Typefully API
      Puppeteer fallback
    Use cases
      Short news post drafting
      Scheduled publishing
      Long article via Typefully
      Meme style joke posts
    Audience
      Content creators
      Claude Code users
      Social media managers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn any article link into a short, styled X post with an optional AI generated poster image.

USE CASE 2

Schedule or publish X posts automatically through Buffer with a confirmation step first.

USE CASE 3

Write and schedule long form X Articles through Typefully, including code blocks and tables.

USE CASE 4

Generate original joke posts based on trending meme formats without copying source images.

What is it built with?

Node.jsPuppeteerBuffer APITypefully API

How does it compare?

cxjwin/x-post-schedulerbrainjs/brainjsreactnativecanfeng6666/tbh-dropmonitor
Stars303030
LanguageJavaScriptJavaScriptJavaScript
Last pushed2018-12-09
MaintenanceDormant
Setup difficultymoderatemoderate
Complexity3/52/5
Audiencevibe coderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a Buffer account and API key, and optionally a Typefully account plus a public GitHub repo for hosting images.

In plain English

x-post-scheduler is a Claude Code skill suite that turns content into posts for X, the platform formerly known as Twitter. You give it an article link, and the agent fetches the page, writes a short commentary style summary in your own voice, optionally creates a themed poster image, and then publishes or schedules the post through a service called Buffer, with the original article link placed in the first reply. It can also write original jokes and publish long form articles through a service called Typefully, since X itself does not support scheduling long articles natively. There are three main features here: short news posts made from an article link with an optional poster image, joke posts that riff on a trending meme format without copying the original image or wording, and long form articles published through Typefully as a draft you preview before it goes out. By default nothing publishes automatically. Before every post, the tool shows you the full text, any image, and the planned time, and waits for your confirmation, though a fully automatic mode can be turned on later once you trust it. Certain sensitive topics such as politics, disasters, unverified accusations, and paywalled content always fall back to requiring manual confirmation regardless of that setting.\n\nSetting it up takes two commands: cloning the repository and running an interactive setup script that walks you through entering your Buffer and Typefully API keys, discovering your connected social accounts, and optionally setting up a public GitHub repository to host poster images, since Buffer can only reference publicly hosted image URLs rather than local files. Node.js version 18 or newer is required, and the core scripts have no external dependencies, though generating HTML based poster images or converting code blocks and tables for long articles needs the Puppeteer library installed separately.\n\nThe README also documents a long list of specific quirks the author ran into, such as image hosting rate limits, font rendering issues with certain bullet characters, and strict filename rules for uploading media to Typefully, all of which the included scripts already handle automatically.

Copy-paste prompts

Prompt 1
Help me run the setup.mjs script to connect my Buffer and Typefully accounts to x-post-scheduler.
Prompt 2
Drop this article link into the skill and show me the draft post before it publishes.
Prompt 3
Explain how this skill converts Markdown tables and code blocks for a long form X Article.
Prompt 4
Walk me through turning on fully automatic publishing mode once I trust the drafts.

Frequently asked questions

What is x-post-scheduler?

A Claude Code skill that turns an article link into a scheduled X post, complete with an optional poster image and a human confirmation step before publishing.

What language is x-post-scheduler written in?

Mainly JavaScript. The stack also includes Node.js, Puppeteer, Buffer API.

How hard is x-post-scheduler to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is x-post-scheduler for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.