x-master

# 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:** ``` https://api.fxtwitter.com/{username}/status/{tweet_id} ``` Extract `username` and `tweet_id` from the x.com URL: - `https://x.com/example/status/1234567890` → `api.fxtwitter.com/example/status/1234567890` - `https://twitter.com/example/status/1234567890` → 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. 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 `reply_to` **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. 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) ``` Got an x.com URL? → Read it: fxtwitter (NEVER direct web_fetch) Need to search X for discourse? → Real-time pulse: xai-grok-search → Deep thread context: x-research-skill → Last 30 days across platforms: last30days-skill Need to post/reply? → Draft → get human approval → execute script Received a mention/reply? → x-engage (generates draft, awaits approval) Need raw API access? → xurl or your configured X API client ``` --- ## Key Resources | Resource | Location | Purpose | |----------|----------|---------| | fxtwitter pattern | `references/fxtwitter-pattern.md` | 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*