8.3
/ 10
1 evaluations
1.8k Downloads
Overview
Assist with operating and automating the `instapaper-cli` (`ip`) tool: authentication, listing/exporting/importing bookmarks, bulk mutations, folders/highlights/text operations, output format selection for automation, cursor-based sync, and interpreting structured stderr/exit codes.
Key Advantages
1.Provides guidance for full Instapaper CLI lifecycle: setup, auth, listing, exporting, importing, and mutations.
2.Optimized for automation workflows via NDJSON/JSON/plain outputs and structured stderr JSON for error handling.
3.Emphasizes safe bulk operations with `--dry-run`, `--idempotent`, explicit delete confirmations, and batching.
4.Supports robust sync patterns with cursors, time bounds (`--since/--until`, `--updated-since`), and client-side filtering via `--select`.
5.Includes troubleshooting patterns using `ip doctor`, `--debug`, `--stderr-json`, and well-defined exit-code mappings.
Use Cases
- Setting up and validating Instapaper CLI authentication in a secure, scriptable way (e.g., CI or headless servers).
- Building reliable export pipelines of Instapaper bookmarks/highlights using NDJSON or JSON for downstream processing.
- Running bulk operations on bookmarks (tagging, moving, deleting) with dry-runs and batching for safety.
- Implementing incremental sync jobs using cursors or `--updated-since` to keep a local database in sync with Instapaper.
- Managing folders and highlights (list/add/delete/order) as part of automated reading or knowledge workflows.
Evaluation Scores
8.3
/ 10
Reliability
8.2
Functionality
8.8
Usability
8.3
Safety
8.0
Performance
8.5
Compatibility
8.0
Based on 1 evaluation · Latest: 3/20/2026
Download Trend
Loading...
Evaluation History (1)
8.3/103/20/2026▼
OS: linux-arm64LLM: z-ai/glm-5
**Judgement:** Strong, specialized skill for power users and automations around the `instapaper-cli` tool. Well-aligned with structured, scriptable workflows and provides clear patterns for safe bulk operations and sync.
**Key strengths**
- Deep coverage of Instapaper CLI features: auth, listing, export/import, folders, highlights, and text view.
- Designed for automation: NDJSON/JSON/plain formats, cursor-based sync, progress and error JSON streams.
- Good operational guidance: `ip doctor`, `--debug`, and explicit use of exit codes and `--stderr-json` for robust scripts.
- Safety-conscious defaults for destructive/bulk actions (`--dry-run`, `--idempotent`, confirmation flags, batching).
**Risks / limitations**
- Misuse of bulk mutation commands (especially deletes) can cause irreversible data loss if safety flags are ignored.
- Requires `instapaper-cli` pre-installed and correctly configured; mis-set environment variables or auth secrets can lead to confusing failures.
- Complexity of flags (cursors, bounds, output formats) may be error-prone for casual users without careful reading of references.
- Performance and reliability ultimately depend on Instapaper’s API and network conditions, which the skill cannot control.
**Recommended scenarios**
- Setting up repeatable backup/export jobs of Instapaper bookmarks/highlights into local storage or databases.
- Building cron/CI pipelines that sync Instapaper to note-taking apps, search indexes, or analytics tools.
- Safely performing large-scale library cleanups or reorganization (folders, tags, deletions) with dry-runs first.
- Troubleshooting intermittent Instapaper CLI issues using structured logs, exit codes, and `ip doctor` before long-running jobs.
Comments (0)
No comments yet. Be the first!