x-skills  by kangarooking

AI-powered X (Twitter) content automation

Created 4 months ago
254 stars

Top 99.0% on SourcePulse

GitHubView on GitHub
Project Summary

A set of Claude Skills designed to automate X (Twitter) content creation, X-Skills assists users in efficiently gathering material, selecting topics, crafting viral tweets, and saving them to drafts. It targets X creators aiming to streamline their content workflow and enhance engagement through a structured, multi-stage process.

How It Works

X-Skills comprises four core skills: x-collect for material gathering using a 4-round simulated human research strategy; x-filter for topic selection via a multi-dimensional weighted scoring system (hotness, controversy, value, relevance) combined with negative sample filtering and diversity control; x-create for tweet generation (short posts, threads, replies) employing intent-driven routing, A/B variants, and a critic self-check mechanism; and x-publish for automating the saving of content to X drafts using Playwright, ensuring user review before posting. The system integrates an X For You-inspired recommendation algorithm, A/B variant generation with critic scoring, and lightweight similarity filtering.

Quick Start & Requirements

Installation involves copying or creating symbolic links for the skill folders (x-collect, x-filter, x-create, x-publish) into the Claude skills directory (~/.claude/skills/). Initial setup is performed by running /x-create and answering configuration questions regarding account positioning, target audience, and persona style. Prerequisites include Python 3.9+, Playwright MCP, and a logged-in X account for the x-publish skill. The x-collect skill requires the WebSearch tool to be available. Relevant links include Claude Code, Playwright MCP, and the X For You Feed Algorithm documentation.

Highlighted Details

  • Features an X For You-inspired recommendation algorithm incorporating multi-source candidates, weighted multi-dimensional scoring, and diversity control mechanisms.
  • Generates A/B variants for tweets, with a critic scoring each variant (0-10) for hook strength, information density, readability, credibility, and action orientation, triggering an auto-rewrite if both variants score below 7.
  • Employs intent-driven routing to automatically select the optimal creation mode based on the desired user action (e.g., collect, retweet, discuss).
  • Includes lightweight similarity filtering using character n-grams and Jaccard similarity to prevent the generation of duplicate or low-quality topics.
  • Supports a feedback loop through liked/rejected topic databases and event logs (JSONL) for state management and continuous improvement.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels such as Discord or Slack.

Licensing & Compatibility

The project is licensed under the Apache License 2.0. This license permits commercial use and linking with closed-source software, adhering to the standard terms of Apache 2.0.

Limitations & Caveats

The x-publish skill only saves content to X drafts, necessitating manual user review and explicit action to post tweets, which is a deliberate safety feature. The effectiveness of the skills relies on the capabilities of the underlying Claude model and external tools like Playwright and WebSearch. Initial configuration requires user input via the /x-create command.

Health Check
Last Commit

3 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
21 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.