x-api
作者 affaan-mx-api 協助你處理 X/Twitter API 的發文、讀取時間軸、搜尋，以及基本分析。它會引導你如何選擇驗證方式、端點與 API 開發任務中的請求格式，包括使用 bearer token 的讀取流程與 OAuth 1.0a 的寫入流程。
這個技能評分為 78/100，對需要 X/Twitter API 指引的目錄使用者來說，是相當穩妥的收錄候選。它清楚支援發文、搜尋、讀取時間軸與驗證模式等常見需求，讓使用者能快速判斷是否符合；但由於沒有專屬安裝指令與支援參考檔，安裝決策上仍稍受限制。
- 對 X 上的發文、讀取、搜尋與分析工作流程，有明確的啟動線索
- 針對 app-only bearer token 與 user-context OAuth 1.0a 都提供具體的驗證範例
- SKILL.md 內容充實，結構化標題與程式碼範例可降低試錯成本
- 沒有安裝指令或搭配的腳本／參考檔，採用時可能需要手動設定
- 內容看起來主要聚焦在核心 API 使用；若需要更深入的營運邊界情境，可能還得查外部文件
x-api 技能概覽
x-api 的用途
x-api 技能可協助你以程式化方式操作 X/Twitter API，進行發文、讀取、搜尋與基本分析。當你需要一個 x-api 技能，把像是「發這則更新」或「抓最近的提及」這類模糊需求，轉成正確的驗證模型、端點選擇與請求格式時，它特別實用。
適合安裝的人
如果你正在打造 bot、社群自動化、內容發布流程，或需要 X 資料的內部工具，就應該安裝 x-api。它尤其適合 API Development 任務，因為你常需要判斷工作是只讀、需要使用者情境的寫入權限，還是以搜尋為主。
為什麼它有用
x-api 的核心價值在於實際的路由判斷：它會把 app-only 讀取時使用的 bearer token，和發文、帳號動作所需的 OAuth 1.0a 區分開來。這能減少你在權限、rate limit，以及在動手寫程式前 API 到底需要哪些輸入欄位上的猜測。
如何使用 x-api 技能
安裝並載入 x-api 技能
先依照目錄的安裝流程安裝 x-api，然後先讀 SKILL.md。如果你的環境支援，可以用以下指令安裝：
npx skills add affaan-m/everything-claude-code --skill x-api
接著檢視技能提供的任何連結倉庫內容。在這個 repo 中，主要來源檔案是 skills/x-api/SKILL.md，而且沒有搭配的 rules/、resources/ 或輔助 script 可用來補齊缺漏行為。
給技能正確的任務形狀
x-api usage 最適合在你一開始就清楚說明三件事時使用：動作、存取層級、目標物件。舉例來說，你可以說「用 bearer token 搜尋最近關於 Claude Code 的貼文」或「用 OAuth 1.0a 從使用者情境發一則 thread」。這遠比「幫我用 X API」更好，因為技能才能把你的意圖對應到正確的驗證方式與端點路徑。
提供正確的輸入細節
對於讀取流程，請包含搜尋查詢、日期區間、結果數量限制，以及你需要的是公開資料還是帳號專屬資料。對於寫入流程，請包含精確的貼文內容、是否需要 thread，以及任何媒體或回覆限制。如果你正在做 x-api for API Development，也請說明執行環境、密鑰儲存方式，以及你是否需要 Python、JavaScript 或 shell 的範例程式碼。
依照這個順序讀取原始內容
先從 SKILL.md 開始，再查看驗證章節與 “When to Activate” 指引。這些內容會告訴你這個需求到底適不適合交給這個技能。如果你要把它改造成自己的工作流程，請先複製決策邏輯，而不是程式碼範例，因為對大多數 x-api 安裝嘗試來說，驗證方式才是主要阻礙。
x-api 技能 FAQ
x-api 只適合發推文嗎？
不是。x-api 技能涵蓋發文、讀取時間軸、搜尋最近內容，以及以分析為導向的資料擷取。如果你的工作只是撰寫文案，一般寫作提示就夠了；但如果你需要內容透過 API 發送到 X，x-api 就是更合適的選擇。
使用前一定要懂 OAuth 嗎？
你不需要是 OAuth 專家，但你必須知道你的任務是 app-only 的讀取權限，還是 user-context 的寫入權限。這是這份 x-api guide 的主要分界，也決定了任何請求開始前你必須提供哪些憑證。
什麼情況下不該用這個技能？
如果你只需要一次性的手動社群貼文、你的組織尚未核准 X API 存取，或你無法提供安全的環境變數，就不要使用 x-api。如果你的需求是跨平台、更廣泛的社群聆聽，它也不是好選擇，因為這個技能是以 X 為中心的。
如何改進 x-api 技能
說明成果，不只指定端點
更好的輸入會帶來更好的 x-api 輸出。與其要求「一個 API call」，不如要求「一個 Python 範例，搜尋 claude code 的最近貼文，回傳 10 筆結果，並從 env vars 讀取 bearer token」。具體的成功標準能幫助技能避免產出過於泛化或不完整的範例。
提供驗證與權限限制
大多數失敗都來自於缺少存取細節。請告訴技能你有 bearer-token access、OAuth 1.0a user context，或兩者皆有，並說明任何限制，例如不能儲存 secrets、不能用 DMs，或只能讀取。這樣可以避免技能推薦你實際上無法使用的驗證流程。
從第一個可運作的請求開始逐步擴充
先從一個端點與一個狹窄用途開始，再慢慢擴展。扎實的 x-api 工作流程通常是：先驗證 authentication，執行一個小型讀取請求，確認 rate-limit 行為，接著再加入發文或分析功能。如果第一個輸出太抽象，請改要求精確的 request、預期 response shape，以及最小限度的錯誤處理，而不是更大範圍的重寫。