Description

Use when operating the instapaper-cli (ip) tool or troubleshooting it: authenticating, listing/exporting/importing bookmarks, bulk mutations, folders/highlights/text, choosing output formats (ndjson/json/plain), cursor-based sync, and interpreting stderr-json/exit codes for automation.

README (SKILL.md)

Instapaper CLI

Name: Instapaper
Author: vburojevic

Overview

Use this skill to handle Instapaper operations via the ip CLI (which must be installed and available in PATH), especially when you need reliable automation, structured output, or troubleshooting guidance.

Install the CLI

Go install: go install github.com/vburojevic/instapaper-cli/cmd/ip@latest
Homebrew: brew tap vburojevic/tap && brew install instapaper-cli
From source: go build ./cmd/ip (run as ./ip)

Workflow (fast path)

Verify setup
- Ensure INSTAPAPER_CONSUMER_KEY and INSTAPAPER_CONSUMER_SECRET are set or passed during login.
- Prefer --password-stdin for auth; never store the password.
- Run ip doctor --json (or ip auth status) before long jobs.
Pick output format for automation
- Default is --ndjson (streaming, one object per line).
- Use --json for single objects or compact arrays.
- Use --plain for stable, line-oriented text.
- Add --stderr-json for structured errors and --progress-json for long runs.
Read data deterministically
- Use list or export with --cursor/--cursor-dir or --since/--until bounds.
- Use --updated-since for incremental sync.
- Use --select for client-side filtering when the API does not support it.
Mutate safely
- Use --dry-run or --idempotent when possible.
- For bulk actions, use --ids or --stdin and consider --batch.
- Deletions require explicit confirmation flags.
Handle extras
- Text view: ip text for article HTML.
- Highlights: ip highlights list/add/delete.
- Folders: ip folders list/add/delete/order.
Troubleshoot
- Use --debug for request timing and status.
- Use --stderr-json and map exit_code to action.

Command reference

Read these when you need exact flags, formats, or examples:

references/commands.md: command-by-command examples for auth, list/export/import, mutations, folders, highlights, and text.
references/output-and-sync.md: output formats, progress streams, cursor/bounds syntax, and filtering.
references/errors.md: exit codes and structured stderr error codes.

Guardrails

Avoid --format table for parsing; it is for humans only.
Use --output or --output-dir for large exports to avoid stdout pressure.
Prefer --password-stdin on Windows to avoid echoing passwords.

Usage Guidance

This skill is an instructions-only guide for the instapaper 'ip' CLI and appears internally consistent. Before using it: (1) verify the ip binary source (check the GitHub repo and the Homebrew tap) before running go install or brew install; (2) keep INSTAPAPER_CONSUMER_KEY/SECRET and your password secret and prefer --password-stdin as the docs advise; (3) review any config/cursor files the tool will read (e.g., ~/.config/ip/*) if you care about data exposure; (4) because the skill metadata doesn't declare those env vars, supplying credentials is a manual step—do not paste them into untrusted prompts or public chat history. If you want higher assurance, run the ip binary in an isolated environment (container/VM) and inspect its network endpoints and code before giving it real credentials.

Capability Analysis

Type: OpenClaw Skill Name: instapaper Version: 0.2.9 The skill bundle provides instructions and examples for installing and using the `instapaper-cli` tool. All commands and documentation are directly related to the stated purpose of managing Instapaper bookmarks. While installation instructions involve fetching and executing code from a remote GitHub repository (`go install github.com/vburojevic/instapaper-cli/cmd/ip@latest`), this is a standard method for installing CLI tools and is transparently presented in `SKILL.md`. There is no evidence of intentional harmful behavior, data exfiltration, unauthorized execution, persistence, or prompt injection attempts against the agent to perform actions beyond the skill's stated purpose.

Capability Assessment

✓ Purpose & Capability

The name/description match the content: the skill is a usage/troubleshooting guide for the instapaper-cli (ip). All commands, flags, cursor/config paths, and output formats described are relevant to that purpose.

ℹ Instruction Scope

Instructions stay within the CLI's scope (auth, list/export/import, mutations, cursors, progress, stderr-json). They reference config/cursor files (e.g., ~/.config/ip/cursor.json) which is expected for a CLI-based sync tool. Note: the SKILL.md recommends INSTAPAPER_CONSUMER_KEY and INSTAPAPER_CONSUMER_SECRET and demonstrates password use, but the registry metadata did not declare required env vars — this is an omission in metadata but not necessarily malicious.

ℹ Install Mechanism

No install spec in the skill bundle (instruction-only), which is low-risk. The docs instruct installing ip via 'go install' or a third‑party Homebrew tap; both are normal but pull code from external sources — verify the repository/tap is legitimate before running those commands.

ℹ Credentials

The only sensitive items mentioned are INSTAPAPER_CONSUMER_KEY and INSTAPAPER_CONSUMER_SECRET and occasional user passwords (with advice to use --password-stdin). Those credentials are proportionate to interacting with Instapaper. However, the skill metadata did not declare them as required env vars, so the guidance to set them is only in the README; treat that as an instruction the operator must follow and protect the secrets accordingly.

✓ Persistence & Privilege

The skill is not always-enabled, does not request persistent system privileges, and contains no install-time hooks or scripts. As instruction-only content it will not autonomously persist or modify other skills' config.

Version History

v0.2.9

- Added installation instructions for the instapaper-cli, including Go install, Homebrew, and building from source. - No other changes to workflows or usage guidance.

v0.2.8

- Added detailed reference files: commands, output-and-sync, and errors. - Updated documentation to clarify that the `ip` CLI must be installed and available in `PATH`.

v0.2.7

instapaper v0.2.7 changelog - Expanded SKILL.md to provide in-depth usage instructions and best practices for the instapaper-cli (`ip`) tool. - Added clear workflow steps for authentication, output formats, deterministic data access, safe mutations, and troubleshooting. - Included concise guidance on advanced features such as incremental sync, batch operations, and structured error handling. - Documented command references and guardrails to prevent common automation pitfalls. - Improved clarity on output options, security (password handling), and automation-friendly best practices.

Metadata

Slug instapaper

Version 0.2.9

License —

All-time Installs 0

Active Installs 0

Total Versions 3

Frequently Asked Questions

What is Instapaper?

Use when operating the instapaper-cli (ip) tool or troubleshooting it: authenticating, listing/exporting/importing bookmarks, bulk mutations, folders/highlights/text, choosing output formats (ndjson/json/plain), cursor-based sync, and interpreting stderr-json/exit codes for automation. It is an AI Agent Skill for Claude Code / OpenClaw, with 2122 downloads so far.

How do I install Instapaper?

Run "/install instapaper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Instapaper free?

Yes, Instapaper is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Instapaper support?

Instapaper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Instapaper?

It is built and maintained by vburojevic (@vburojevic); the current version is v0.2.9.

More Skills

Instapaper