← 返回 Skills 市场
Instapaper
作者
vburojevic
· GitHub ↗
· v0.2.9
2122
总下载
2
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install 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.
使用说明 (SKILL.md)
Instapaper CLI
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_KEYandINSTAPAPER_CONSUMER_SECRETare set or passed during login. - Prefer
--password-stdinfor auth; never store the password. - Run
ip doctor --json(orip auth status) before long jobs.
- Ensure
-
Pick output format for automation
- Default is
--ndjson(streaming, one object per line). - Use
--jsonfor single objects or compact arrays. - Use
--plainfor stable, line-oriented text. - Add
--stderr-jsonfor structured errors and--progress-jsonfor long runs.
- Default is
-
Read data deterministically
- Use
listorexportwith--cursor/--cursor-diror--since/--untilbounds. - Use
--updated-sincefor incremental sync. - Use
--selectfor client-side filtering when the API does not support it.
- Use
-
Mutate safely
- Use
--dry-runor--idempotentwhen possible. - For bulk actions, use
--idsor--stdinand consider--batch. - Deletions require explicit confirmation flags.
- Use
-
Handle extras
- Text view:
ip textfor article HTML. - Highlights:
ip highlights list/add/delete. - Folders:
ip folders list/add/delete/order.
- Text view:
-
Troubleshoot
- Use
--debugfor request timing and status. - Use
--stderr-jsonand mapexit_codeto action.
- Use
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 tablefor parsing; it is for humans only. - Use
--outputor--output-dirfor large exports to avoid stdout pressure. - Prefer
--password-stdinon Windows to avoid echoing passwords.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install instapaper - 安装完成后，直接呼叫该 Skill 的名称或使用
/instapaper触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2122 次。
如何安装 Instapaper？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install instapaper」即可一键安装，无需额外配置。
Instapaper 是免费的吗？
是的，Instapaper 完全免费（开源免费），可自由下载、安装和使用。
Instapaper 支持哪些平台？
Instapaper 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Instapaper？
由 vburojevic（@vburojevic）开发并维护，当前版本 v0.2.9。
推荐 Skills