← Back to Skills Marketplace
1912
Downloads
2
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install x-bookmark-archiver
Description
Fetch your X bookmarks, auto-categorize by URL, generate AI summaries, and save organized markdown archives in your OpenClaw workspace.
Usage Guidance
This appears to be a genuine X bookmarks archiver. Before installing or running: 1) Inspect and (optionally) run the tests in an isolated/temp directory to verify behavior. 2) Be aware the tool will: run the local bird CLI (so bird must be installed and authenticated), perform HEAD requests to each bookmarked URL (which will contact arbitrary hosts and could reach internal resources if such URLs exist), and call api.openai.com when OPENAI_API_KEY is set. 3) If you prefer output and state in safe locations, set OPENCLAW_WORKSPACE and X_BOOKMARK_STATE_DIR to directories you control (the latter is supported by the code but not documented in SKILL.md). 4) Note the small path inconsistencies (SKILL.md mentions ~/clawd while state.cjs uses ~/.clawd); verify the actual directories used on your machine. 5) Only provide an OPENAI_API_KEY if you want AI summaries; otherwise the tool will fall back to simple metadata. If you plan to allow autonomous agent invocation, remember this skill will perform network requests and write files — grant only if you trust it to act on your behalf.
Capability Analysis
Type: OpenClaw Skill
Name: x-bookmark-archiver
Version: 1.0.0
The OpenClaw AgentSkills skill bundle 'x-bookmark-archiver' is classified as benign. Its core functionality involves executing the `bird CLI` to fetch X (Twitter) bookmarks, making HTTPS requests to expand `t.co` URLs, and optionally calling the OpenAI API for AI-generated summaries (if `OPENAI_API_KEY` is provided). All file system operations are confined to the OpenClaw workspace and a designated state directory. The `SKILL.md` provides clear instructions for the user and does not contain any prompt injection attempts against the agent. All observed behaviors are directly aligned with the stated purpose of archiving X bookmarks.
Capability Assessment
Purpose & Capability
Name/behavior align: scripts fetch X bookmarks via the bird CLI, categorize them, optionally call OpenAI to generate summaries, and write markdown files into an OpenClaw workspace. The required binaries and optional OPENAI_API_KEY are appropriate for this functionality.
Instruction Scope
Runtime instructions and scripts stay within the stated purpose (fetch → process → write markdown). The code performs network HEAD requests to bookmarked URLs (expandUrl) and POSTs to api.openai.com when OPENAI_API_KEY is present; these network calls are expected here but mean the tool will contact arbitrary bookmarked hosts and OpenAI. The scripts read and write files in the user's home directories (workspace and state).
Install Mechanism
No install spec — skill is instruction-plus-source included in the bundle. There are no downloads or external installers invoked by the skill itself. All code is included in the package.
Credentials
The skill only requires an optional OPENAI_API_KEY for AI summaries and allows overriding workspace via OPENCLAW_WORKSPACE and OPENCLAW_PROFILE. However, the state code accepts X_BOOKMARK_STATE_DIR (used to set where pending/processed JSON live) but this env var is not documented in SKILL.md. Also SKILL.md and code disagree on legacy vs dot-prefixed state/workspace paths (e.g., ~/clawd vs ~/.clawd), which is an implementation inconsistency but not a secret-exfiltration risk.
Persistence & Privilege
The skill does not request always:true or other elevated platform privileges. It writes its own state/markdown files under user-owned directories and does not attempt to modify other skills or system-wide configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-bookmark-archiver - After installation, invoke the skill by name or use
/x-bookmark-archiver - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of x-bookmark-archiver.
- Archive your X (Twitter) bookmarks into organized markdown files with optional AI-generated summaries.
- Automatically categorizes bookmarks by URL domain (tools, articles, videos, research, news, bookmarks).
- CLI workflow for fetch, process, and full pipeline; supports environment variable configuration.
- AI enrichment for title, summary, and tags (requires OpenAI API key, optional).
- Tracks processing state to avoid duplicate archiving.
- Customizable categories, output locations, and AI providers.
- Includes detailed documentation, extensive test suite, and troubleshooting guide.
Metadata
Frequently Asked Questions
What is X Bookmarks Archiver?
Fetch your X bookmarks, auto-categorize by URL, generate AI summaries, and save organized markdown archives in your OpenClaw workspace. It is an AI Agent Skill for Claude Code / OpenClaw, with 1912 downloads so far.
How do I install X Bookmarks Archiver?
Run "/install x-bookmark-archiver" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Bookmarks Archiver free?
Yes, X Bookmarks Archiver is completely free (open-source). You can download, install and use it at no cost.
Which platforms does X Bookmarks Archiver support?
X Bookmarks Archiver is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Bookmarks Archiver?
It is built and maintained by Iamadig (@iamadig); the current version is v1.0.0.
More Skills