← Back to Skills Marketplace
X Bookmark Triage
by
Jeremy Knows
· GitHub ↗
· v1.0.0
· MIT-0
250
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install x-bookmark-triage
Description
Automatically triages X/Twitter bookmarks into structured knowledge cards and posts them to a Discord channel (#knowledge-intake or similar). Captures tweet...
Usage Guidance
What to check before installing or running this skill:
- Metadata mismatch: The registry listing claims no required env vars, but the code requires X OAuth credentials, a Discord bot token, and an Anthropic API key. Do not rely on the registry metadata; follow SKILL.md and inspect scripts before running.
- Secrets exposure: The scripts will read/write token files under a workspace data/ directory, and they will fall back to a secrets JSON in parent directories and (via run-poll.sh) may read an OpenClaw gateway plist using PlistBuddy. Only run this under an account where those fallback paths are safe and won’t expose other secrets. Prefer to run in an isolated workspace and set env vars directly rather than relying on auto-discovery.
- Refresh-token handling: X rotates refresh tokens. The code writes new refresh tokens to data/x-oauth2-new-refresh-token.txt and asks you to manually update your environment/plist. Consider using a proper secrets manager to automate write-back if you want that behavior; otherwise rotating tokens may break background runs.
- Least privilege: If you do not want bookmarks automatically deleted, avoid granting bookmark.write scope (or run with --no-unbookmark / remove delete calls). Review bookmark-unbookmark calls before providing write scope.
- Review prompts & network calls: The skill sends tweet/web content to an external LLM (Anthropic) and uses third-party proxies (fxtwitter, markdown.new). If you have privacy concerns about sending content to those endpoints, do not enable the triage or remove/modify the network calls.
- File permissions & logs: Files written by the skill (token cache, new-refresh-token file, seen.json) should be protected (scripts set 0o600 for token file). Confirm logs and data files are stored where you control access.
- Run a dry test first: Use --dry-run and limited --limit to test behaviour, run setup-check.js, and inspect the written data files. Consider running the code locally (manual triage of a single URL) before scheduling cron/launchd/OpenClaw tasks.
If you want help reviewing specific files (e.g., the gateway plist you plan to point to, or the secrets file path), provide them and I can highlight exact lines that read or write secrets.
Capability Analysis
Type: OpenClaw Skill
Name: x-bookmark-triage
Version: 1.0.0
The skill bundle is a well-documented and functional utility for triaging X/Twitter bookmarks into Discord knowledge cards using Claude Haiku. It implements a standard OAuth 2.0 PKCE flow for X API access and uses a 'no-dependency' approach, relying on system 'curl' and Node.js built-ins rather than external NPM packages. While it utilizes third-party proxies like 'fxtwitter.com' and 'markdown.new' to extract content and handles sensitive API secrets, the code includes proper security practices such as token storage with restricted permissions (0o600), input encoding (encodeURIComponent), and safe sub-process execution (spawnSync with JSON-stringified payloads). The behavior is transparent and strictly aligned with the stated purpose.
Capability Assessment
Purpose & Capability
Functionality (X OAuth, Discord posting, Anthropic triage) matches the stated purpose. However the registry metadata lists no required env vars or credentials while SKILL.md and the scripts clearly require X OAuth credentials, a Discord bot token, and an Anthropic API key — this mismatch is an incoherence in the package metadata.
Instruction Scope
SKILL.md and the scripts instruct the agent/process to read token caches and secrets files, write rotated refresh tokens to disk, and read a gateway plist via PlistBuddy. The code also fetches content via fxtwitter and markdown.new, posts to the Discord API, and calls the Anthropic API. These actions are consistent with triage but the scripts also look for secrets in paths outside the skill (workspace parent directories and a ../.. /secrets path) and will attempt to read a gateway plist — which could expose other environment variables if that file is used system-wide.
Install Mechanism
There is no remote install step and this is an instruction+script bundle (no external downloads). That keeps install risk low. The code runs child processes (curl, sleep, node) and writes files to a local data/ directory — expected for this tool.
Credentials
The credentials requested by the code (X_OAUTH2_CLIENT_ID, X_OAUTH2_CLIENT_SECRET, X_OAUTH2_REFRESH_TOKEN, DISCORD_BOT_TOKEN, ANTHROPIC_DEFAULT_KEY) are proportionate to the stated function. Concern: the scripts will also try to load a secrets JSON from a parent 'secrets' directory if env vars are missing, and run-poll.sh can extract env vars from an OpenClaw gateway plist via PlistBuddy — both behaviors reach outside the local skill folder to read secrets. The registry record claiming 'no required env vars' is inconsistent with the actual requirements.
Persistence & Privilege
The skill is not force-installed (always: false) and does not modify other skills. It suggests scheduling via cron/launchd/OpenClaw at the user's choice — this is reasonable for a polling/daemon task. The scripts do write token caches and seen-index files in data/ (normal for this use case).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-bookmark-triage - After installation, invoke the skill by name or use
/x-bookmark-triage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. X/Twitter bookmark → Discord knowledge card pipeline. Tier scoring, freshness, topic tags, auto-unbookmark. Standalone (no OpenClaw required).
Metadata
Frequently Asked Questions
What is X Bookmark Triage?
Automatically triages X/Twitter bookmarks into structured knowledge cards and posts them to a Discord channel (#knowledge-intake or similar). Captures tweet... It is an AI Agent Skill for Claude Code / OpenClaw, with 250 downloads so far.
How do I install X Bookmark Triage?
Run "/install x-bookmark-triage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Bookmark Triage free?
Yes, X Bookmark Triage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X Bookmark Triage support?
X Bookmark Triage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Bookmark Triage?
It is built and maintained by Jeremy Knows (@jeremyknows); the current version is v1.0.0.
More Skills