Agent Skills

Skills are packaged tool configurations for AI coding agents — Claude Code, Cursor, Windsurf, and 40+ others. Each skill is a SKILL.md file that gives your agent the right tool permissions, context, and instructions for working with Reedle.

Skills vs MCP

SkillsMCP
ForAI coding agents (Claude Code, Cursor, Windsurf)AI chat clients (Claude Desktop, Cursor chat)
How it worksSKILL.md gives agent CLI access + tool permissionsMCP server exposes library as chat tools
InterfaceAgent runs reedle CLI commands + MCP toolsNatural language: "Search my library for..."
Best forAutomations, pipelines, coding workflowsResearch, summarization, Q&A

Install the Reedle skill

Terminal
# Install for current project
npx skills add iopho-team/iopho-skills --skill reedle

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

This adds a SKILL.md to .claude/skills/reedle/ (Claude Code) or .agents/skills/reedle/ (other agents). Your agent now has scoped access to the reedle CLI and Reedle MCP tools.

What the skill enables

  • Run any reedle * CLI command (save, cat, search, browse, star, archive, etc.)
  • Access Reedle MCP tools as fallback when CLI isn't available
  • Save/read decision guidance — agent won't pollute your library without intent
  • Piping patterns: reedle cat <id> into prompts, glow, or other tools

Available iopho skills

SkillDescriptionInstall
reedleReading library CLI — save/read articles, YouTube & Bilibili transcripts, semantic search, highlights, flashcard decksnpx skills add iopho-team/iopho-skills --skill reedle
pnotePromptNote CLI — manage prompts, notes, and snippetsnpx skills add iopho-team/iopho-skills --skill pnote

Source: github.com/iopho-team/iopho-skills

Prerequisites

  • Install the CLI: npm install -g reedle-cli
  • Authenticate: reedle auth token rdk_xxx
  • Optionally set up the MCP server for chat-mode access