Agent skill

X Bookmarks

Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2.

No licenceAuto-check: notesProductivity & Automation

Install X Bookmarks

skills CLI

$ npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install sharbelxyz/x-bookmarks x-bookmarks --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "x-bookmarks" agent skill from https://github.com/sharbelxyz/x-bookmarks/tree/main into .claude/skills/x-bookmarks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-bookmarks", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install sharbelxyz/x-bookmarks x-bookmarks --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "x-bookmarks" agent skill from https://github.com/sharbelxyz/x-bookmarks/tree/main into .agents/skills/x-bookmarks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-bookmarks", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install sharbelxyz/x-bookmarks x-bookmarks --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "x-bookmarks" agent skill from https://github.com/sharbelxyz/x-bookmarks/tree/main into .cursor/skills/x-bookmarks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-bookmarks", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install sharbelxyz/x-bookmarks x-bookmarks --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "x-bookmarks" agent skill from https://github.com/sharbelxyz/x-bookmarks/tree/main into .gemini/skills/x-bookmarks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-bookmarks", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install sharbelxyz/x-bookmarks x-bookmarks

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "x-bookmarks" agent skill from https://github.com/sharbelxyz/x-bookmarks/tree/main into .github/skills/x-bookmarks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-bookmarks", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install sharbelxyz/x-bookmarks x-bookmarks --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "x-bookmarks" agent skill from https://github.com/sharbelxyz/x-bookmarks/tree/main into .opencode/skills/x-bookmarks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-bookmarks", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: x-bookmarks
GitHub stars: 289
Token cost: ~2k tokens
SKILL.md length: 630 words
Files: 7 (incl. scripts, references)
Skills in repo: 1
Repo updated: Feb 15, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2.

Works in 7 steps: bird CLI (preferred if available) → X API v2 (fallback) → Action-First Digest (Primary Use Case) → …
User says check my bookmarks
SKILL.md covers Data Source Selection, Fetching Bookmarks, JSON Output Format (both… and Core Workflows, plus 2 more sections
Runs Python and Shell scripts from its folder; calls python3 and npm; needs AUTH_TOKEN and X_API_BEARER_TOKEN

What it does

X Bookmarks is an agent skill from sharbelxyz/x-bookmarks. Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2. Use when: (1) user says "check my bookmarks", "what did I bookmark", "bookmark digest", "summarize my bookmarks", "x bookmarks", "twitter bookmarks", (2) user wants a periodic digest of saved tweets, (3) user wants to categorize, search, or analyze their bookmarks, (4) scheduled bookmark digests via cron. Auth: bird CLI with browser cookies, OR X API v2 with OAuth 2.0 tokens.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `README.md`, `references/auth-setup.md` and `scripts/fetch_bookmarks.sh`).

It sits in Productivity & Automation, covering Scheduled and recurring tasks, Social media posts and OAuth and OpenID Connect. It works with X (Twitter). The repository describes itself as: OpenClaw skill: turn your X bookmarks into agent actions. Stop hoarding. Start applying.

When your agent uses it

User says check my bookmarks
What did I bookmark
Bookmark digest
Summarize my bookmarks

Example prompts

“check my bookmarks”
“what did I bookmark”
“bookmark digest”
“/x-bookmarks”

Requirements

Python 3
Node.js
A Bash shell
A credential in AUTH_TOKEN
A credential in X_API_BEARER_TOKEN

Workflow steps

7 steps, taken from the step headings in SKILL.md.

bird CLI (preferred if available)
X API v2 (fallback)
Action-First Digest (Primary Use Case)
Scheduled Digest (Cron)
Content Recycling
Pattern Detection
Bookmark Cleanup

What it can do on your machine

Read from SKILL.md and the folder at commit acf1860. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (Python and Shell), which the agent can run.
Shell commands in SKILL.md call:
- python3
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- AUTH_TOKEN
- X_API_BEARER_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Bookmarks loads about 2k tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 116 tokens; SKILL.md has 630 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~116
When it runs · the whole SKILL.md, loaded when a task matches: ~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:19

- .env.bird: "Optional: stores AUTH_TOKEN and CT0 for bird CLI"

NoteMentions a .env fileSKILL.md:25

sourced from .env.bird), or (2) X API v2 with OAuth 2.0 tokens stored locally.

NoteMentions a .env fileSKILL.md:87

If user has a `.env.bird` file or env vars `AUTH_TOKEN`/`CT0`, source them first: `source .env.bird`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 630 words (~1,996 tokens).

“Turn X/Twitter bookmarks from a graveyard of good intentions into actionable work.”

— opening of SKILL.md by sharbelxyz

name: x-bookmarks
version: 1.1.0
security.credentials: This skill accesses X/Twitter bookmarks, which requires authentication. Two methods are supported: (1) bird CLI using browser cookies (AUTH_TOKEN/CT0 env vars…

Read the full SKILL.md on GitHub

Files

SKILL.md and 6 other files (scripts, references) in the repository root of sharbelxyz/x-bookmarks.

SKILL.md
.gitignore
README.md
references/auth-setup.md
scripts/fetch_bookmarks.sh
scripts/fetch_bookmarks_api.py
scripts/x_api_auth.py

Open the folder on GitHubat commit acf1860

Compare with similar skills

X Bookmarks next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Bookmarks compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
X Bookmarks this skillsharbelxyz/x-bookmarks	289	—	~2k	Automated safety check: Notes	None	7 mo ago
Twitter Monitorkangarooking/kangarooking-skills	662	—	~798	Automated safety check: Pass	None	1 mo ago
X APIsundial-org/awesome-openclaw-skills	663	—	~598	Automated safety check: Pass	None	7 mo ago
Twitterapi IokaitoInfra/twitterapi-io	451	—	~3.1k	Automated safety check: Pass	MIT	today
Xquik MCPXquik-dev/x-twitter-scraper	211	1 repos	~997	Automated safety check: Pass	MIT	today
X APIaffaan-m/ECC	277k	5 repos	~1.9k	Automated safety check: Warn	MIT	today

Similar skills

Twitter Monitor
kangarooking/kangarooking-skills
Fetch recent posts from one or more X/Twitter accounts through twitterapi.io, output structured JSON/CSV records, optionally sync records to Feishu/Lark Bitable through feishu-cli, and optionally…
662 GitHub stars~798 tokensUpdated 1 mo ago
Productivity & AutomationAuto-check passed
X API
sundial-org/awesome-openclaw-skills
Post to X (Twitter) using the official API with OAuth 1.0a. An agent skill from sundial-org/awesome-openclaw-skills.
663 GitHub stars~598 tokensUpdated 7 mo ago
Backend & APIsAuto-check passed
Twitterapi Io
kaitoInfra/twitterapi-io
Official skill for twitterapi.io — query Twitter/X data (tweets, profiles, followers, advanced search, trends, spaces, communities, lists) and perform authenticated actions (post, reply, like…
451 GitHub stars~3.1k tokensUpdated today
Backend & APIsAuto-check passed
Xquik MCP
Xquik-dev/x-twitter-scraper
Connect, verify, and troubleshoot Xquik's remote MCP server.
211 GitHub starsUsed in 1 repo~997 tokens
Backend & APIsAuto-check passed
X API
affaan-m/ECC
X/Twitter API integration for posting tweets, threads, reading timelines, search, and analytics.
277k GitHub starsUsed in 5 repos~1.9k tokens
Backend & APIsAuto-check: warnings
X Post Publisher
JimLiu/baoyu-skills
Publishes text posts, images, videos, quote posts and long-form X Articles written in Markdown through a real Chrome browser.
27k GitHub starsUsed in 1 repo~4.4k tokens
Productivity & AutomationAuto-check: warnings

Works with

X (Twitter)

Questions about X Bookmarks

What does X Bookmarks do?

Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2. X Bookmarks is an agent skill from sharbelxyz/x-bookmarks. Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2.

When should I use X Bookmarks?

X Bookmarks fits situations like: user says check my bookmarks; what did I bookmark; bookmark digest; summarize my bookmarks.

How do I install X Bookmarks in Claude Code?

Run `npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a claude-code`. Or copy the skill folder (the sharbelxyz/x-bookmarks repository) into .claude/skills/x-bookmarks in your project. Claude Code loads it when a task matches its description.

How do I install X Bookmarks in Codex?

Run `npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a codex`. Or copy the skill folder (the sharbelxyz/x-bookmarks repository) into .agents/skills/x-bookmarks in your project. Codex loads it when a task matches its description.

Can I use X Bookmarks in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sharbelxyz/x-bookmarks --skill x-bookmarks -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-bookmarks, .gemini/skills/x-bookmarks, .github/skills/x-bookmarks and .opencode/skills/x-bookmarks in your project.

What does X Bookmarks need to run?

Going by SKILL.md and its folder, X Bookmarks needs Python and a shell for the scripts in its folder, the command-line tools its instructions call (python3 and npm) and credentials named AUTH_TOKEN and X_API_BEARER_TOKEN. Our summary lists: Python 3; Node.js; A Bash shell; A credential in AUTH_TOKEN; A credential in X_API_BEARER_TOKEN.

Does X Bookmarks access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is X Bookmarks safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does X Bookmarks use?

No licence was found for X Bookmarks or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does X Bookmarks use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 893 tokens, read only when the agent opens those files.

What are the alternatives to X Bookmarks?

Skills that share tags, products or a category with X Bookmarks: Twitter Monitor (kangarooking/kangarooking-skills, 662 stars), X API (sundial-org/awesome-openclaw-skills, 663 stars), Twitterapi Io (kaitoInfra/twitterapi-io, 451 stars) and Xquik MCP (Xquik-dev/x-twitter-scraper, 211 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Bookmarks?

sharbelxyz (a GitHub user) maintains it in sharbelxyz/x-bookmarks, which has 289 GitHub stars. The repository was last updated on February 15, 2026.

Source: sharbelxyz/x-bookmarks on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install X Bookmarks

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Twitter Monitor

X API

Twitterapi Io

Xquik MCP

X API

X Post Publisher

Related

Questions about X Bookmarks