x-post-craft
Write and review X/Twitter posts and threads using the reach mechanics of X's open-source recommendation stack. Privacy: instruction-only skill; ships no scripts and makes no network requests.
Requirements
- None beyond a coding agent that supports Agent Skills
Install
Pi
# pinned (versions are listed in the changelog linked below)
pi install npm:@ayagmar/x-post-craft@<version>
# unpinned
pi install npm:@ayagmar/x-post-craft
# remove
pi remove npm:@ayagmar/x-post-craft
skills CLI
npx skills add ayagmar/agents-skills --skill x-post-craft --agent pi
Other agent ids: claude-code, codex, cursor.
Claude Code
claude plugin marketplace add ayagmar/agents-skills
claude plugin install x-post-craft@ayagmar-skills
Codex
codex plugin marketplace add ayagmar/agents-skills
codex plugin add x-post-craft@ayagmar-skills
Usage
Prompt examples: "Rewrite this draft for X and tell me what would hurt its reach." or "Write a caption for this video." It works for any subject and tone: jokes, photos and clips, opinions, news, personal updates, or work. The agent loads the skill when your request matches its description. See SKILL.md for the full workflow and references/algorithm-notes.md for the evidence behind each rule.
What it optimizes for
- Conversation and depth signals (replies, author-engaged replies, clicks, dwell, profile visits, bookmarks, shares) over vanity likes
- Avoiding the penalties that matter most: negative feedback, spam and toxicity labels, hostile text, burst posting, and "See fewer" feedback fatigue
- Plain, specific writing that fits the kind of post, from a one-line caption to a thread
Algorithm notes are based on the open-source repository twitter/the-algorithm. This skill is not affiliated with or endorsed by X Corp.