jnkindi/x-post-generator-skill

x-post-generator-skill is an Agent Skill, a packaged set of instructions that AI coding assistants like Claude Code, Codex CLI, or Gemini CLI can load and use automatically when a matching request comes in. This particular skill turns any subject, such as a product launch, a research paper, a codebase, or an analysis, into a full Twitter and X content plan. Rather than just generating tweet text, the skill maps every drafting decision to how the Twitter and X ranking algorithm actually scores posts, based on the public xai-org/x-algorithm project. It looks at specific signals the algorithm rewards, like replies, dwell time, quotes, and profile clicks, and specific signals it penalizes, like getting blocked, muted, or reported. Before writing anything, the workflow requires reading primary sources on the subject first, since the author's view is that generic posts do not perform well while specific ones do. The final output is a single markdown document containing a summary of the subject, ranked post ideas grouped by expected performance, a posting schedule spanning one to two weeks, adapted versions for Hacker News, Reddit, and Substack, and a checklist of suggested visuals. Installing it means cloning the repository into the skill folder your particular AI agent looks for, with the folder name kept as x-post-generator-skill so the tool can recognize it. For agents that do not support the Agent Skills format yet, the project suggests pasting the markdown files as context or combining them into a rules file instead. The tool only covers Twitter and X for the main output, with Hacker News, Reddit, and Substack as secondary formats. It does not post anything itself or connect to any API, it only produces the written plan. It is licensed under MIT.