home / skills / openclaw / skills / x-kindle

x-kindle skill

safe

This skill sends selected X posts to Kindle by converting tweets to HTML emails via SMTP, enabling distraction-free reading.

npx playbooks add skill openclaw/skills --skill x-kindle

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.4 KB

---
name: x-to-kindle
description: Send X/Twitter posts to Kindle for distraction-free reading. Use when user shares an X/Twitter link and wants to read it on Kindle, or asks to send a tweet/thread to their Kindle device.
---

# X to Kindle

Convert X/Twitter posts into Kindle-readable documents via email.

## Requirements

- Gmail account with App Password (or other SMTP setup)
- Kindle email address (found in Amazon account settings)

## Workflow

When user shares an X link:

1. **Extract content** via fxtwitter API:
   ```
   https://api.fxtwitter.com/status/<tweet_id>
   ```
   Extract from URL: `twitter.com/*/status/<id>` or `x.com/*/status/<id>`

2. **Format as HTML email**:
   ```html
   <html>
   <body>
     <h1>@{author_handle}</h1>
     <p>{tweet_text}</p>
     <p><em>{timestamp}</em></p>
     <p><a href="{original_url}">View on X</a></p>
   </body>
   </html>
   ```

3. **Send via SMTP** to user's Kindle address with subject line as tweet preview.

## Configuration

Store in TOOLS.md:
```markdown
## Kindle
- Address: [email protected]

## Email (Gmail SMTP)
- From: [email protected]
- App Password: xxxx xxxx xxxx xxxx
- Host: smtp.gmail.com
- Port: 587
```

## Example

User sends: `https://x.com/elonmusk/status/1234567890`

1. Fetch `https://api.fxtwitter.com/status/1234567890`
2. Extract author, text, timestamp
3. Send HTML email to Kindle address
4. Confirm: "Sent to Kindle 📚"

Overview

This skill converts X/Twitter posts and threads into Kindle-ready HTML emails so you can read them on a Kindle device without distractions. It accepts an X/Twitter link, fetches the post content, formats a simple HTML document, and sends it to your Kindle email via SMTP. The result is a clean, readable view of tweets and threaded conversations on your device.

How this skill works

When you share an X link, the skill extracts the tweet ID and fetches content from an API endpoint to retrieve author, text, media links, and timestamp. It composes a minimal HTML email containing the tweet or thread, author handle, timestamp, and a link back to the original post. The skill then sends the HTML to the configured Kindle email address using SMTP credentials (for example Gmail with an app password). Finally, it confirms delivery to the user.

When to use it

You want to read a single tweet or threaded conversation on a Kindle for focused, distraction-free reading.
You save long or important threads for later review during commutes or reading sessions.
You archive notable tweets to your Kindle for offline reading and annotation.
You prefer a clean, readable layout without the X/Twitter interface or ads.

Best practices

Use a dedicated Gmail account with an app password or secure SMTP setup to avoid exposing primary credentials.
Whitelist your sending email in your Amazon Manage Your Content and Devices settings so Kindle accepts the incoming messages.
Strip or host heavy media externally to keep emails lightweight and compatible with Kindle rendering.
Include the original post URL in the email so you can jump back to the source if needed.
Test with a single tweet before enabling bulk or automated sending to confirm formatting and delivery.

Example use cases

Send an insightful 10-tweet thread to your Kindle to read on a long flight.
Archive a CEO announcement tweet to your Kindle for later analysis and annotation.
Turn a news thread into a Kindle-friendly article for distraction-free reading.
Forward frequently referenced tweets to your Kindle collection for offline access.

FAQ

What do I need to configure before using the skill?

You need a Kindle email address added to your Amazon whitelist and SMTP credentials (Gmail with an app password or other SMTP) configured as the sender.

Will images and videos appear on my Kindle?

Kindles have limited media support. Images can be included but may be resized or omitted; videos will be converted to links to view on the original site.