Reedle Skill

The reedle agent skill gives Claude Code, Cursor, Windsurf, and compatible agents scoped access to your Reedle reading library — via the CLI and MCP tools. It is part of the iopho-skills open-source skill registry.

Install

Terminal

# Current project
npx skills add iopho-team/iopho-skills --skill reedle

# Global (all projects)
npx skills add iopho-team/iopho-skills --skill reedle -g -y

Installs to .claude/skills/reedle/SKILL.md (Claude Code) or .agents/skills/reedle/SKILL.md (other agents).

Prerequisites

Setup

# 1. Install the CLI
npm install -g reedle-cli

# 2. Authenticate with your PAT
#    Get from: Reedle → Settings → Integrations → CLI Token
reedle auth token rdk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 3. (Optional) Set up MCP for chat-mode fallback
#    See: /docs/mcp/setup

Allowed tools

The skill grants your agent permission to run these tools:

Tool	Scope
`Bash(reedle *)`	Any `reedle` CLI command
Reedle MCP tools	All `reedle_*` MCP tools as fallback when CLI is unavailable

The skill does not grant general Bash access — only the reedle command prefix is allowed.

Save vs Read — decision rule

The skill includes guidance so your agent makes the right choice between saving to library and reading without saving:

Use `reedle save` / `reedle_save`	Use `reedle read` / `reedle_read`
User explicitly asks to save an article	User wants to read/summarize without adding to library
User wants it available offline or for later review	One-time extraction for a pipeline or prompt
User wants highlights, flashcards, or AI chat on the article	Scratchpad extraction — ephemeral use

Default: prefer read (non-destructive). Only call save when the user clearly intends to add to their library.

CLI command groups

Auth

`reedle auth token <rdk_xxx>`	Set PAT
`reedle auth whoami`	Show current user
`reedle auth logout`	Remove credentials

Save to library

`reedle save <url>`	Save web article. Async — use `reedle show <id>` to check status.
`reedle save-youtube <url>`	Save YouTube video with transcript
`reedle save-bilibili <url> --cookie <str>`	Save Bilibili video transcript

Read without saving

`reedle read <url>`	Extract content to stdout. Costs credits.
`reedle read <url> --youtube`	Extract YouTube transcript
`reedle read <url> --bilibili --cookie <str>`	Extract Bilibili transcript

Library navigation

`reedle list`	List articles. Flags: `-t <tag>`, `--starred`, `-s <status>`, `--json`
`reedle show <id>`	Article metadata: title, URL, status, tags, highlight count
`reedle cat <id>`	Full article content to stdout
`reedle open <id>`	Open in browser
`reedle search <query>`	Keyword search. Add `--semantic` for AI search.
`reedle tags`	All tags with counts
`reedle lists`	All reading lists

Actions

`reedle star <id>` / `unstar`	Star or unstar
`reedle archive <id>` / `unarchive`	Archive or restore
`reedle delete <id> --force`	Soft-delete (requires --force)
`reedle tag <id> <tag>` / `untag`	Add or remove tag

Interactive TUI

reedle browse Fuzzy-search library with live preview. Requires fzf. See Browse TUI →

MCP fallback tools

When running without CLI access (e.g. in a restricted environment), the skill falls back to MCP tools:

MCP tool	CLI equivalent
`reedle_save`	`reedle save <url>`
`reedle_save_youtube`	`reedle save-youtube <url>`
`reedle_save_bilibili`	`reedle save-bilibili <url>`
`reedle_read`	`reedle read <url>`
`reedle_read_youtube`	`reedle read <url> --youtube`
`reedle_read_bilibili`	`reedle read <url> --bilibili`
`reedle_list_articles`	`reedle list`
`reedle_get_article_content`	`reedle cat <id>`
`reedle_search_semantic`	`reedle search --semantic`
`reedle_get_processing_status`	`reedle show <id>` (status field)

See the full MCP tools reference →

Scripting patterns

Examples

# Read and summarize an article without saving
reedle read https://arxiv.org/abs/2310.06825 | llm summarize

# Search library and get content for context
reedle search "attention mechanisms" --semantic --json | jq -r '.[0].id' | xargs reedle cat

# Save with tags then pipe content
reedle save https://example.com/paper -t research -t llm
reedle list -t research --json | jq -r '.[0].id' | xargs reedle cat | glow