Add send-to-kindle extension

extensions/send-to-kindle/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

extensions/send-to-kindle/.gitignore

@@ -0,0 +1,15 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+
+# Raycast specific files
+raycast-env.d.ts
+.raycast-swift-build
+.swiftpm
+compiled_raycast_swift
+compiled_raycast_rust
+
+# misc
+.DS_Store
+/skill-raycast

extensions/send-to-kindle/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "printWidth": 120,
+  "singleQuote": false
+}

extensions/send-to-kindle/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Send to Kindle Changelog
+
+## [Smarter Skills, Cleaner Previews] - 2026-02-16
+
+- New CSS selector algorithm: smarter ranking now highlights high-confidence selectors first, so you find the right filter faster with fewer trial-and-error steps.
+- Filter and cover reset controls in Preview mode
+- Content search in Add Filter Skill: cleaner skill management and quicker discovery, directly where you work.
+- Fixed absolute image handling in Markdown: image links are now reliably normalized, for more stable previews and cleaner Kindle rendering.
+
+## [Skills and Preview Improvements] - 2026-02-16
+
+- Added guided cover skill creator action in the Preview and Send to Kindle command
+- Added the guided filter skill creator action in the Preview and Send to Kindle command
+- Added metadata view in the Preview and Send to Kindle command
+- Added the View Cover action in the Preview and Send to Kindle command
+- Added send to Kindle history, to see previously sent articles
+- Skills are now unique per domain: adding a skill for an existing domain updates that domain entry instead of creating a new skill.
+- When adding a skill to an existing domain, CSS selectors are merged with the existing selectors (without duplicates) instead of overwriting them.
+- Improved direct-send (no preview) feedback: the delivery flow now keeps an animated toast and transitions to an explicit success toast.
+- Added a `Copy Original Source Code` action in `Preview and Send to Kindle` to copy the full original page HTML. This is useful when prompting an AI to identify a CSS selector you can later add as a skill to remove recurring unwanted elements on that site.
+
+## [Initial Version] - 2026-02-16

extensions/send-to-kindle/README.md

@@ -0,0 +1,249 @@
+# Send to Kindle (Raycast)
+
+Send the current browser article to Kindle as a clean EPUB, with domain-based cleanup skills, cover control, edit-before-send, and delivery by email or the Send to Kindle desktop app.
+
+## What This Extension Does
+
+- Extracts readable article content from the active browser tab
+- Applies per-domain "skills" (CSS filters + cover selectors)
+- Lets you preview and edit title/content before sending
+- Generates a Kindle-friendly EPUB with inlined images
+- Delivers through:
+  - `Email (Recommended)` via SMTP
+  - `Send to Kindle app (Mac)` local app handoff
+
+## Advantages vs Official "Send to Kindle" Chrome Extension
+
+| Feature | This Raycast extension | Official Chrome extension |
+| ------------------------------------------------------ | ---------------------- | ------------------------- |
+| Outdated UX | ❌ | ✅ |
+| Readability.js-based extraction for better results | ✅ | ❌ |
+| Custom per-domain CSS filters | ✅ | ❌ |
+| Manual cover photo selection (`Cover CSS`) | ✅ | ❌ |
+| Guided cover selector picker (`Add Cover Skill`) | ✅ | ❌ |
+| Guided filter selector (`Add Filter Skill`) | ✅ | ❌ |
+| Cover preview before sending | ✅ | ❌ |
+| Edit content before sending | ✅ | ❌ |
+| Faster (in email mode) | ✅ | ❌ |
+| Uses site name instead of article author name | ✅ | ❌ |
+| Import/export filter profiles (JSON) | ✅ | ❌ |
+| Two delivery methods (local app or email) | ✅ | ❌ |
+| Optional removal of all article links before sending | ✅ | ❌ |
+| Sending history | ✅ | ❌ |
+
+## Cover Skill vs Filter Skill
+
+The extension uses 2 complementary skill types per domain. 
+
+When a skill is added, it is applied to all the future articles you will send from that domain.
+
+- `Filter Skill`
+  - Removes unwanted page blocks before extraction (ads, sidebars, popups, cookie walls, related-content blocks).
+  - Goal: cleaner article body and better readability output.
+
+- `Cover Skill`
+  - Targets the best image to use as the Kindle cover.
+  - Goal: consistent, high-quality cover image instead of random inline article images (or no image at all with the official "Send to Kindle Chrome extension").
+
+In short:
+
+- `Filter Skill` improves article content quality.
+- `Cover Skill` improves book cover quality.
+
+## Current Command Set
+
+### `Send to Kindle`
+
+Direct send with no preview UI.
+
+- Loads active tab content
+- Builds EPUB
+- Sends immediately with your configured delivery method
+- Adds entry to history
+
+### `Preview and Send to Kindle`
+
+Full preview workflow with metadata and actions.
+
+Main actions:
+
+- `Send to Kindle`
+- `View Cover` (if cover can be resolved)
+- `Add Cover Skill` (guided image candidate picker)
+- `Add Filter Skill` (guided selector suggestion list with ranking)
+- `Edit Content` (title + markdown body)
+- `Copy Original Source Code`
+- `Copy Markdown`
+- `Reset Cover Skills for This Domain`
+- `Reset Filter Skills for This Domain`
+- `Reset All Skills for This Domain`
+- `Reveal Output Folder`
+
+### `Add a Skill`
+
+Create/update a domain skill manually:
+
+- `Domain`
+- `CSS Filter` (elements to remove)
+- `Cover CSS` (cover image selector(s))
+
+Includes JSON import action from the form.
+
+### `My Skills`
+
+Manage existing skills:
+
+- Search by domain/selector
+- Edit
+- Delete
+- Export skill JSON
+- Add a new skill
+
+### `Send to Kindle History`
+
+View previous sends with:
+
+- Timestamp
+- Open in browser
+- Remove one entry
+- Clear all history
+
+### `Set / Change Sending Method`
+
+Configure and validate delivery mode:
+
+- `Send to Kindle app (Mac)`
+- `Email (Recommended)` with SMTP test before save
+
+## Delivery Modes
+
+### Email (Recommended)
+
+Sends the EPUB attachment directly to your Kindle email address.
+
+Required fields:
+
+- `Kindle Address` (for example `name@kindle.com`)
+- `Sender Address` (Need to be in your Amazon Send to Kindle allowlist)
+- `SMTP Server`
+- `SMTP Port`
+- `SMTP Security` (`SSL/TLS`, `STARTTLS`, `None`)
+- `SMTP Username`
+- `SMTP Password`
+
+During setup, the extension tests SMTP connection/authentication and recipient acceptance before saving.
+
+### Send to Kindle app (Mac)
+
+Writes the EPUB and opens it with the Amazon Send to Kindle app. If Raycast cannot open the app directly, it tries to find a compatible app by name.
+
+## Skill System
+
+A skill is a per-domain profile:
+
+- `domain`
+- `selector` (content cleanup)
+- `coverSelector` (cover lookup)
+
+Behavior:
+
+- Skills are unique per domain
+- Adding a skill on an existing domain merges selectors (deduplicated)
+- Domain matching supports subdomains (`news.example.com` can reuse `example.com`)
+- You can reset only cover selectors, only content selectors, or all skills for a domain
+
+### Guided Skill Creation in Preview
+
+`Add Cover Skill`:
+
+- Scans source images
+- Shows visual candidates (width/height + selector)
+- Saves selected selector as `Cover CSS`
+
+`Add Filter Skill`:
+
+- Extracts selector candidates from readable content
+- Ranks them with confidence/specificity/risk scores
+- Shows recommended subset first, with option to load all selectors
+
+### Skill Import/Export
+
+Skills can be transferred as JSON files.
+
+- Export format: `send-to-kindle-skill` v1 payload
+- Import accepts the same format (or direct filter object)
+
+## Extension Preferences
+
+In Raycast extension preferences:
+
+- `Share EPUB cover image` (default: on)
+  - If off, no cover is embedded in EPUB.
+- `Disable article links` (default: off)
+  - If on, links are stripped while keeping link text.
+
+## How the Pipeline Works
+
+1. Read active tab HTML through the Raycast browser extension.
+2. Apply domain skill filters (`CSS Filter`).
+3. Extract article content with `@mozilla/readability`.
+4. Convert extracted content to markdown.
+5. Build EPUB-compatible HTML from markdown.
+6. Fetch and inline images into EPUB resources.
+7. Resolve cover:
+   - first from skill cover selectors,
+   - fallback to first valid article image.
+8. Build EPUB and send using configured delivery method.
+
+## Requirements
+
+1. Raycast installed
+2. This extension installed
+3. Raycast browser extension enabled (required to access active tab content)
+4. Amazon Kindle account configured
+5. For email mode:
+   - Kindle email address
+   - sender approved in Amazon Send-to-Kindle settings
+   - valid SMTP credentials
+
+## Platform Notes (macOS + Windows)
+
+- Extension platform target is `macOS` and `Windows`.
+- Email workflow is the most reliable cross-platform path.
+- `Send to Kindle app` mode is intended for the macOS Amazon app.
+- Some image conversion/resizing paths rely on macOS `sips`, so behavior can differ on Windows for WebP/AVIF-heavy pages.
+
+## Gmail Setup (If You Use Gmail SMTP)
+
+Use an app password, not your main Google password.
+
+Suggested values:
+
+- SMTP server: `smtp.gmail.com`
+- Port: `587`
+- Security: `STARTTLS`
+- Username: your Gmail address
+- Password: Google App Password
+
+Useful docs:
+
+- [Gmail SMTP setup](https://support.google.com/mail/answer/7104828?hl=en&visit_id=639059758371114804-114182322&rd=1)
+- [Google App Passwords](https://support.google.com/mail/answer/185833?sjid=16238667612725057818-EU)
+
+## Troubleshooting
+
+- `Raycast browser extension is not available`
+  - Install/enable the Raycast browser extension and retry.
+- `Unable to load page` / extraction fails
+  - Try `Preview and Send to Kindle`, then add filter skills for that domain.
+- Cover missing
+  - Add a `Cover CSS` selector with `Add Cover Skill`.
+- SMTP setup failed
+  - Recheck host/port/security/credentials and Amazon sender allowlist.
+- Send to Kindle app not found
+  - Install Amazon app or switch to `Email (Recommended)`.
+
+## Data & Storage
+
+- Skills, history, and sending settings are stored in Raycast LocalStorage.
+- Generated EPUB files are created in the extension support path and cleaned after send attempts.

extensions/send-to-kindle/eslint.config.js

@@ -0,0 +1,6 @@
+const { defineConfig } = require("eslint/config");
+const raycastConfig = require("@raycast/eslint-config");
+
+module.exports = defineConfig([
+  ...raycastConfig,
+]);