agentleFS
rameerezrameerez/claude-code-startup-skills/skills/x-post/SKILL.md

x-post

Skill30 starsChanged 9 months agoMITView on GitHub

Post to X (Twitter) from the command line. Text, images, and video.

  • Installs packages

17 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use x-dm, x-human and 6 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • JakeschincariolSkill

    x-dm

    Write X DMs that get answered - the first message, the two follow-ups - and triage the user's DM inbox and message requests. Use when the user says "DM this person", "cold DM", "outreach on X", "how do I follow up", "what do I say to this DM", "go through my message requests", or is reaching out to someone specific on X.

    Also in 3 projects that use this

  • JakeschincariolSkill

    x-human

    Strip the machine fingerprint out of any draft - em dashes, AI slop words, invisible watermark characters, thread boilerplate - and score it against a five-check detection panel before it goes out. Use whenever text needs to sound human, when the user says humanize, "does this sound like AI", "remove the em dashes", "de-slop this", "this sounds like ChatGPT", or before any post, thread, reply or DM from this pack is shown to the user.

    Also in 3 projects that use this

  • lleqsnoomSkill

    x-plan

    Plan before coding — research the project and the web first, ask short plain questions until the user is sure, propose three approaches with trade-offs, then write a layered spec (contract, invariant, test) as a graph-driven scenario with guards and a memory file; gate on user approval

    Also in 3 projects that use this

  • lxyang20131208-starSkill

    x-audit

    Audit a draft X (Twitter) post or thread against the open-source X algorithm BEFORE publishing. Use when the user shares a tweet draft and wants feedback, asks "will this do well on X / Twitter", "review my post", "is this good to post", or wants to improve reach before posting. Returns a PASS / FLAG / BLOCK verdict per dimension plus a concrete rewrite.

    Also in 3 projects that use this

  • lxyang20131208-starSkill

    x-reply

    Build a reply-based growth strategy for a new or small X (Twitter) account, and draft high-quality replies. Use when the user has few followers, asks "how do I grow on X from zero", "my account is new", "who should I reply to", "help me write a reply to this tweet", or wants a cold-start plan. Returns an anchor-account strategy and concrete reply drafts.

    Also in 3 projects that use this

  • +1 more from Jakeschincariol
  • +2 more from lxyang20131208-star

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 9 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Always show the user the exact tweet text before posting and get confirmation

    line 49
  2. Distinctive:

    Never post without explicit user approval

    line 50

“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Post to X using the CLI tool at ~/.claude/skills/x-post/x-post.py.

Setup

Requires Python packages: pip install xdk requests_oauthlib

Credentials file at ~/.claude/skills/x-post/x.key (JSON):

{
  "api_key": "...",
  "api_secret": "...",
  "access_token": "...",
  "access_token_secret": "..."
}

Commands

Post text:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text"

Post with image:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/image.jpg

Post with video:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/video.mp4

Check profile:

python ~/.claude/skills/x-post/x-post.py me

Rules

  • Always show the user the exact tweet text before posting and get confirmation
  • Never post without explicit user approval
  • Video uploads use chunked upload (INIT/APPEND/FINALIZE) and may take a minute for processing
  • The script auto-detects media type from file extension

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.