← 返回 Skills 市场
jeremyknows

X Bookmark Triage

作者 Jeremy Knows · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
250
总下载
0
收藏
2
当前安装
1
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
功能分析
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.
能力评估
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).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install x-bookmark-triage
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /x-bookmark-triage 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release. X/Twitter bookmark → Discord knowledge card pipeline. Tier scoring, freshness, topic tags, auto-unbookmark. Standalone (no OpenClaw required).
元数据
Slug x-bookmark-triage
版本 1.0.0
许可证 MIT-0
累计安装 2
当前安装数 2
历史版本数 1
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 250 次。

如何安装 X Bookmark Triage?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install x-bookmark-triage」即可一键安装,无需额外配置。

X Bookmark Triage 是免费的吗?

是的,X Bookmark Triage 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

X Bookmark Triage 支持哪些平台?

X Bookmark Triage 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 X Bookmark Triage?

由 Jeremy Knows(@jeremyknows)开发并维护,当前版本 v1.0.0。

💬 留言讨论