X Master Skill — Master Routing for X/Twitter Operations

This skill is the single entry point for all X/Twitter work. Read it first, then route to the correct sub-tool based on your task. Never attempt raw x.com fetches. Never guess at routing.

---

⚠️ ABSOLUTE RULE: Never fetch x.com directly

Direct web_fetch of x.com or twitter.com URLs will fail silently or return garbage.

Always use fxtwitter for reading tweet content:
CODEBLOCK0

Extract username and tweet_id from the x.com URL:

• - https://x.com/example/status/1234567890 → INLINECODE4
• INLINECODE5 → same pattern

This is a hard rule. No exceptions. See references/fxtwitter-pattern.md for full details.

---

Account Configuration

This skill routes posting operations to one or more X accounts. Before using, configure your target account(s):

Configuration	What It Means	Approval Required?
Single account	All posts go to one account	Yes — always. Get human approval before posting.
Multiple accounts

Route based on content type | Yes — always. Confirm account + text before posting. |
| Draft-only mode | Generate drafts, never auto-post | Recommended for new users. Learn the flow first. |

Golden rule: Never post autonomously to X. Always draft first, get human approval before publishing.

Posting flow:

1. 1. Draft the post in your voice
2. Share draft with the human for approval (via chat, email, or local review)
3. Only after approval: execute posting script
4. Log the URL and confirmation

---

Task Router

1. Read a tweet or thread by URL

Tool: fxtwitter API via web_fetch When: You have an x.com/twitter.com link and need to read the content How:

web_fetch("https://api.fxtwitter.com/{username}/status/{id}")

Response includes: full text, author, engagement stats, media URLs, thread context via INLINECODE8

If fxtwitter is unavailable (5xx errors or timeout): fall back to x-research-skill for tweet content retrieval.

---

2. Search X for real-time opinions or discourse

Tool: xai-grok-search skill
When: "What are people saying about X", "search X for Y", real-time pulse check, breaking news context
Notes:

• - Responses may take 30–60s (involves reasoning)
• Results include citations with URLs
• Use for real-time social sentiment

---

3. Deep X research — threads, profiles, discourse

Tool: x-research-skill
When: Need to research a topic across many tweets, follow a conversation, understand discourse depth, or cache results
Supports: Filtering by handle, sorting by engagement, saving results for reuse

---

4. Multi-platform trend research (last 30 days)

Tool: last30days-skill
When: "What's trending about X topic", understanding broader cultural moments across Reddit + X + HN + YouTube
Triggers: Trend research requests, topic popularity analysis

---

5. Post a tweet, reply, or quote tweet

Tool: Custom posting script (see Setup)
When: Any posting action. Always requires human approval first.

Posting flow:

1. 1. Draft the tweet in your voice
2. Share draft with human for approval
3. After approval: execute posting script
4. Log the URL in your conversation/record

Never skip the approval step. Even if you think you have permission, confirm the exact text before executing.

---

6. Handle mentions / replies to your account

Tool: x-engage skill
When: Your account receives a mention, reply, or engagement
Notes:

• - Drafts replies automatically
• Always get human approval before posting
• Provides thread context for informed responses

---

7. Direct X API v2 calls

Tool: xurl skill (or your configured X API client)
When: Specific API operations — follower management, analytics, batch operations, anything not covered above
Requires: X OAuth configured in your environment

---

Decision Tree (Quick Reference)

CODEBLOCK2

---

Key Resources

Resource	Location	Purpose
fxtwitter pattern	INLINECODE15	How and why to use fxtwitter; error handling
Algorithm intelligence

references/algo-intel.md | 2026 X ranking signals, engagement weights, strategy |
| Skill dependencies | README.md § Sub-Skills | What to install and when |
| Account config template | config/accounts.json.example | Starting point for posting setup |
| Posting script | scripts/x-post.js (if bundled) | Executes approved posts |
| xurl skill docs | ~/.openclaw/skills/xurl/ or clawhub | Direct X API v2 access |
| x-engage skill docs | ~/.openclaw/skills/x-engage/ or clawhub | Mention handling pipeline |

What Was Deprecated / Removed from X Tooling

If you're migrating from older X agent setups, be aware:

Tool/Pattern	Status	Replacement
Herald/Barker agent	Deprecated — purpose-built X agents are fragile	x-engage skill handles mentions
x-twitter-api npm package

Deleted — third-party duplicate | xurl (first-party) |
| x-react.js / x-poll.js | Archived — standalone reaction scripts | Covered by xurl |
| Direct x.com web_fetch | Never worked reliably | fxtwitter (mandatory) |

---

Algorithm Intelligence (Updated 2026-03-13)

For full details, see references/algo-intel.md

Key Takeaways

• - Engagement hierarchy: Replies (27x) and conversations (150x) beat likes (human accounts — see note below)
• Velocity window: Posts live or die in first 30 minutes
• Content format: Native video > threads > articles > images > text
• Account signals: X Premium, verification, consistency matter
• Posting frequency: >5x/day triggers suppression

⚠️ Bot/AI account note: Engagement weights above apply to human accounts. AI assistant or bot accounts are weighted differently by the algorithm. See references/algo-intel.md § "Strategy by Account Type" for bot-specific guidance.

⚠️ Freshness: Algorithm data last verified 2026-03-13. If today is past 2026-06-13, check references/algo-intel.md for a newer version before relying on specific weights.

For Best Results

• - Lead with video (15–30s, captions, motion hook)
• Reply to your own posts within 15 minutes of publishing
• Post at your audience's peak times
• Engagement pods and clickbait are algorithmically penalized

---

This skill was created for AI agents to route X/Twitter work correctly. Adapt the account routing and approval flow to your needs, but keep the fxtwitter rule and task router structure unchanged.

Version: 1.0.0 | License: MIT