X Bookmarks Digest

Fetch, analyse, and digest your X/Twitter bookmarks into actionable insights.

When to Use

Activate this skill when the user says anything like:

• - "digest x bookmarks"
• "check my bookmarks"
• "review my x bookmarks"
• "what's interesting in my bookmarks?"
• "bookmark digest"
• "any good stuff in my twitter bookmarks?"

Prerequisites Check

Before running the workflow, verify xurl authentication:

CODEBLOCK0

If 401/Unauthorized:
Tell the user to set up xurl authentication:

xurl auth apps add <app-name> --client-id <id> --client-secret <secret>

Then run xurl auth default <app-name> to set it as default.
Do NOT proceed until auth works. Stop and report the issue.

Workflow — Step by Step

Step 1: Check Rate Limit

Read the state file to check when the last run was:

CODEBLOCK2

If last_run_ts is less than 1 hour ago, warn the user:

"Last digest was run at {time}. Free tier allows max 1 run/hour. Use --force to override."

Only proceed if:

• - No previous run exists, OR
• More than 1 hour has elapsed, OR
• User explicitly says to force/override

Step 2: Fetch Bookmarks

Run the fetch script to get new bookmarks:

CODEBLOCK3

Options:

• - --count N — number of bookmarks to fetch (default 50, max 100)
• INLINECODE3 — skip rate limit check
• INLINECODE4 — fetch all (ignore last-checked ID, reprocess everything)

Output: JSON array of bookmark objects to stdout.
Side effect: Updates {baseDir}/state.json with new watermark.

If the output is empty or [], report: "No new bookmarks since last check."

Step 3: Analyse Bookmarks

Pipe the fetched bookmarks through the analyser:

CODEBLOCK4

Or if you saved fetch output to a variable, pass it via file:

CODEBLOCK5

Output: Structured JSON with categories and relevance scores:
CODEBLOCK6

Step 4: Generate Digest

Using the structured analysis output, write a digest following this format:

CODEBLOCK7

Step 5: Decide on Actions

For each high-value bookmark, decide:

Bookmark Type	Action
GitHub repo / tool	Propose git clone or INLINECODE8
Clawhub-compatible skill

Propose clawhub install <slug> |
| Interesting project to build | Propose scaffolding a new skill in skills/ |
| Useful article/thread | Propose saving to Obsidian vault |
| Tip/technique | Propose saving to OpenClaw memory |

Ask the user which actions to execute. Do not auto-execute without confirmation.

Step 6: Update State

After successful digest, verify state was updated:

CODEBLOCK8

Should show updated last_bookmark_id and last_run_ts.

Error Handling

Problem	Action
xurl not found	Tell user: INLINECODE13
xurl 401

Guide user through xurl auth apps add setup | | xurl 429 (rate limit) | Report rate limit hit. Suggest waiting 15 mins. | | Empty bookmarks | Report "No bookmarks found" — user may need to bookmark posts first | | No new bookmarks | Report "No new bookmarks since {lastrunts}" | | state.json missing | First run — create fresh state after fetch | | Python error | Print stderr, check Python 3.10+ installed |

Test Commands

Quick test (dry run, no state update):
CODEBLOCK9

Or just say: "digest x bookmarks" to run the full workflow.

Configuration

All config is in {baseDir}/state.json:

• - last_bookmark_id — watermark for incremental fetches
• INLINECODE17 — rate limit enforcement
• INLINECODE18 — running total of processed bookmarks

No additional configuration files needed. xurl manages its own auth.