How do I install the Stitch skill?

Run npx skillmds@latest add robrohan/stitch 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 Stitch 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 Stitch?

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 Stitch free to use?

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

Who published Stitch?

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

Stitch by robrohan — Agent Skill

Name: Stitch
Author: robrohan

File contents

The user wants to run stitch to extract e-reader highlights.

If arguments were provided ($ARGUMENTS), use them to infer the device type and/or output file. Otherwise, ask the user which device type they want (kobo or kindle) and whether they have an input path or want to rely on environment variables.

How to run stitch

stitch [-i input_file] [-o output_file.json] -t [kobo|kindle]

Options:

-t kobo or -t kindle — required
-i <path> — path to the input file (overrides env vars and defaults)
-o <path> — output JSON file (defaults to kobo.json or kindle.json)

Typical input paths:

OS	Device	Path
macOS	Kindle	`/Volumes/Kindle/documents/My Clippings.txt`
macOS	Kobo	`/Volumes/KOBOeReader/.kobo/KoboReader.sqlite`
Linux	Kindle	`/media/$USER/Kindle/documents/My Clippings.txt`
Linux	Kobo	`/media/$USER/KOBOeReader/.kobo/KoboReader.sqlite`

Environment variables (set these to skip -i each time):

STITCH_KOBO — path to the Kobo SQLite file
STITCH_KINDLE — path to the Kindle clippings file

Prerequisites

Before running stitch, make sure the binary is installed. If stitch is not found on the PATH, tell the user to download the appropriate binary for their platform from:

https://github.com/robrohan/stitch/releases

On macOS, after downloading, the user must right-click the binary in Finder and select "Open" once to bypass the unsigned binary warning before it can be used from the terminal.

Steps

Check that stitch is available by running which stitch. If not found, stop and direct the user to download it from the releases page above.
Determine device type from $ARGUMENTS or ask the user.
Determine input path: check if STITCH_KOBO / STITCH_KINDLE is set, or ask the user for the path.
Run stitch -t <type> [-i <input>] [-o <output>] using the Bash tool.
If successful, read back the output JSON with the Read tool and summarise:
- How many highlights were found
- How many unique books/titles
- Any annotations present
Offer to filter or query the results further with jq.

Notes

The output always ends with a trailing {} — this is expected, not an error.
If the device file is not accessible, stitch exits 0 but logs a warning to stderr. Tell the user to check the device is mounted and the path is correct.
id fields are base64-encoded SpookyHashes of the highlight text — stable across runs.

---name: stitchdescription: Run `stitch` to extract highlights from a Kindle or Kobo e-reader and write them to a JSON file. Use when the user wants to dump, export, or query their e-reader highlights.---The user wants to run `stitch` to extract e-reader highlights.If arguments were provided (`$ARGUMENTS`), use them to infer the device type and/or output file. Otherwise, ask the user which device type they want (`kobo` or `kindle`) and whether they have an input path or want to rely on environment variables.## How to run stitch```stitch [-i input_file] [-o output_file.json] -t [kobo|kindle]```**Options:**- `-t kobo` or `-t kindle` — **required**- `-i <path>` — path to the input file (overrides env vars and defaults)- `-o <path>` — output JSON file (defaults to `kobo.json` or `kindle.json`)**Typical input paths:**| OS | Device | Path ||----|--------|------|| macOS | Kindle | `/Volumes/Kindle/documents/My Clippings.txt` || macOS | Kobo | `/Volumes/KOBOeReader/.kobo/KoboReader.sqlite` || Linux | Kindle | `/media/$USER/Kindle/documents/My Clippings.txt` || Linux | Kobo | `/media/$USER/KOBOeReader/.kobo/KoboReader.sqlite` |**Environment variables (set these to skip `-i` each time):**- `STITCH_KOBO` — path to the Kobo SQLite file- `STITCH_KINDLE` — path to the Kindle clippings file## PrerequisitesBefore running stitch, make sure the binary is installed. If `stitch` is not found on the PATH, tell the user to download the appropriate binary for their platform from:https://github.com/robrohan/stitch/releasesOn macOS, after downloading, the user must right-click the binary in Finder and select "Open" once to bypass the unsigned binary warning before it can be used from the terminal.## Steps1. Check that `stitch` is available by running `which stitch`. If not found, stop and direct the user to download it from the releases page above.2. Determine device type from `$ARGUMENTS` or ask the user.2. Determine input path: check if `STITCH_KOBO` / `STITCH_KINDLE` is set, or ask the user for the path.3. Run `stitch -t <type> [-i <input>] [-o <output>]` using the Bash tool.4. If successful, read back the output JSON with the Read tool and summarise: - How many highlights were found - How many unique books/titles - Any annotations present5. Offer to filter or query the results further with `jq`.## Notes- The output always ends with a trailing `{}` — this is expected, not an error.- If the device file is not accessible, stitch exits `0` but logs a warning to stderr. Tell the user to check the device is mounted and the path is correct.- `id` fields are base64-encoded SpookyHashes of the highlight text — stable across runs.

Frequently asked questions

Stitch