← ClaudeAtlas

x-bookmarkslisted

Use when the user asks to fetch, search, review, summarize, digest, or act on X/Twitter bookmarks, saved posts, bookmark folders, no-credit bookmark access, or recurring bookmark reviews.
heyNag/charms · ★ 1 · AI & Automation · score 70
Install: claude install-skill heyNag/charms
# x-bookmarks Use this skill when a user asks to fetch, search, review, summarize, digest, or act on X/Twitter bookmarks, saved posts, bookmark folders, or recurring bookmark reviews. ## Operating Rules - Prefer Bird via `bird.fast` first because it uses the logged-in browser session and avoids paid X API credits. - Use X API v2 only when Bird cannot work, when the user explicitly asks for the official API path, or when API-specific behavior such as listing folders is needed. - Bundled helpers do not change the X account. Keep OAuth scopes to: `tweet.read users.read bookmark.read offline.access`. - Do not pass `--include-write-scope` to `x_api_auth.py` for the bundled fetch workflows. Request `bookmark.write` only for a separate, explicitly authorized write workflow. - Do not ask for browser cookies, `auth_token`, `ct0`, OAuth tokens, access tokens, refresh tokens, or client secrets in chat. - Do not print tokens, cookies, or raw local auth files. Helper JSON can contain account IDs and bookmark content; keep raw output local and expose only the fields needed for the user's request. - Default local auth and review state lives under `~/.config/x-bookmarks/`, `~/.local/state/x-bookmarks/`, and `~/.config/bird/`. - `X_BOOKMARKS_CONFIG_DIR`, `X_BOOKMARKS_TOKEN_FILE`, and `X_BOOKMARKS_STATE_FILE` can override the x-bookmarks defaults. Keep every override outside the plugin and source checkout. - If auth fails, report the status and a safe fix command wit