x-bookmarkslisted
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