How do I install the X To Kindle skill?

Run npx skillmds@latest add javimosch/x-to-kindle in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is X To Kindle safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X To Kindle?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is X To Kindle free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published X To Kindle?

javimosch (@javimosch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X To Kindle by javimosch — Agent Skill

Name: X To Kindle
Author: javimosch

File contents

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:

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

Format as HTML file (save to /tmp):

<!DOCTYPE html>
<html>
<head><meta charset="UTF-8"><title>{title}</title></head>
<body style="font-family: Georgia, serif; max-width: 600px; margin: 0 auto; padding: 20px; line-height: 1.6;">
  <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>

Send via SMTP with HTML as ATTACHMENT (Kindle requires attachment, not inline HTML):

from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders

msg = MIMEMultipart()
msg['Subject'] = "Tweet from @handle"
msg['From'] = from_email
msg['To'] = kindle_email

# Plain text body (not the content)
msg.attach(MIMEText("Article attached.", 'plain'))

# HTML file as attachment - THIS IS REQUIRED
with open("/tmp/article.html", "rb") as f:
    attachment = MIMEBase('text', 'html')
    attachment.set_payload(f.read())
    encoders.encode_base64(attachment)
    attachment.add_header('Content-Disposition', 'attachment', filename='article.html')
    msg.attach(attachment)

Tools

send_to_kindle: Send a local file to the configured Kindle email.

Configuration

Set the following environment variables in your Clawdbot configuration (or .env file):

SMTP_EMAIL: Your sender email (e.g., gmail)
SMTP_PASSWORD: Your app password
KINDLE_EMAIL: Your Kindle email address
SMTP_SERVER: (Optional) Default: smtp.gmail.com
SMTP_PORT: (Optional) Default: 587

Tool Definitions

send_to_kindle

Send a local file (PDF, HTML, TXT) to the Kindle.

Run: python3 skills/x-to-kindle/send_to_kindle.py <file_path>

Configuration

Store in TOOLS.md:

## Kindle
- Address: user@kindle.com

## Email (Gmail SMTP)
- From: your@gmail.com
- App Password: xxxx xxxx xxxx xxxx
- Host: smtp.gmail.com
- Port: 587

Example

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

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

---name: x-to-kindledescription: 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 KindleConvert 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)## WorkflowWhen 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 file** (save to /tmp): ```html <!DOCTYPE html> <html> <head><meta charset="UTF-8"><title>{title}</title></head> <body style="font-family: Georgia, serif; max-width: 600px; margin: 0 auto; padding: 20px; line-height: 1.6;"> <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 with HTML as ATTACHMENT** (Kindle requires attachment, not inline HTML): ```python from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.base import MIMEBase from email import encoders msg = MIMEMultipart() msg['Subject'] = "Tweet from @handle" msg['From'] = from_email msg['To'] = kindle_email # Plain text body (not the content) msg.attach(MIMEText("Article attached.", 'plain')) # HTML file as attachment - THIS IS REQUIRED with open("/tmp/article.html", "rb") as f: attachment = MIMEBase('text', 'html') attachment.set_payload(f.read()) encoders.encode_base64(attachment) attachment.add_header('Content-Disposition', 'attachment', filename='article.html') msg.attach(attachment) ```## Tools- `send_to_kindle`: Send a local file to the configured Kindle email.## ConfigurationSet the following environment variables in your Clawdbot configuration (or `.env` file):- `SMTP_EMAIL`: Your sender email (e.g., gmail)- `SMTP_PASSWORD`: Your app password- `KINDLE_EMAIL`: Your Kindle email address- `SMTP_SERVER`: (Optional) Default: smtp.gmail.com- `SMTP_PORT`: (Optional) Default: 587## Tool Definitions### send_to_kindleSend a local file (PDF, HTML, TXT) to the Kindle.- **Run:** `python3 skills/x-to-kindle/send_to_kindle.py <file_path>`## ConfigurationStore in TOOLS.md:```markdown## Kindle- Address: user@kindle.com## Email (Gmail SMTP)- From: your@gmail.com- App Password: xxxx xxxx xxxx xxxx- Host: smtp.gmail.com- Port: 587```## ExampleUser sends: `https://x.com/elonmusk/status/1234567890`1. Fetch `https://api.fxtwitter.com/status/1234567890`2. Extract author, text, timestamp3. Send HTML email to Kindle address4. Confirm: "Sent to Kindle 📚"

Frequently asked questions

X To Kindle

File contents

X to Kindle

Requirements

Workflow

Tools

Configuration

Tool Definitions

send_to_kindle

Configuration

Example

Related skills

Frequently asked questions

How do I install the X To Kindle skill?

What does the X To Kindle skill do?

Is X To Kindle safe to use?

Which AI agents work with X To Kindle?

Is X To Kindle free to use?

Who published X To Kindle?