← Back to Skills Marketplace
203
Downloads
2
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install puzle-read
Description
Connect to Puzle Read — an intelligent reading workbench that helps users turn articles and documents into searchable personal knowledge. Save web articles (...
Usage Guidance
This skill implements a normal client/CLI for the Puzle Read service. Before installing: (1) Confirm you trust the external host (https://read-web.puzle.com.cn) and review its privacy/retention policy — uploaded files (PDFs, images, audio, etc.) are sent to that service. (2) Do not upload sensitive or regulated data unless you accept that external processing and storage. (3) The device-auth flow requires you to paste a short authorization code; the resulting JWT is stored locally at ~/.config/puzle/config.json (file is created with 0600 perms). (4) Note a minor metadata inconsistency: the SKILL.md documents this token flow but the registry entry did not declare a primary credential. If you need higher assurance, inspect scripts/puzle_reading.py yourself or avoid uploading confidential files.
Capability Analysis
Type: OpenClaw Skill
Name: puzle-read
Version: 0.1.5
The skill provides a legitimate integration with the Puzle Read service for saving articles, uploading documents, and performing semantic searches. The Python SDK (puzle_reading.py) implements standard API interactions and follows security best practices for credential management, such as storing JWT tokens with restricted file permissions (0o600) and avoiding exposure in logs or environment variables. The instructions in SKILL.md are well-structured, providing clear guidance for the agent on authentication flows and data privacy warnings without any evidence of malicious intent or prompt injection attacks.
Capability Assessment
Purpose & Capability
The skill name, SKILL.md, and bundled Python SDK implement a reading library client (save URLs, upload files, search) and are consistent with the description. Minor metadata mismatch: registry metadata lists no primary credential, but SKILL.md documents a device-auth JWT stored in ~/.config/puzle/config.json as the primary credential — this is implementation-local (file-based) rather than an environment variable.
Instruction Scope
Runtime instructions are scoped to: checking/setting a local token, instructing the user through a device-auth flow, and saving/processing URLs or local files. The skill reads local files only when the user asks to upload them and sends them to the Puzle service. There are no instructions to read unrelated system files, environment variables, or to transmit data to unexpected endpoints.
Install Mechanism
No install spec or external downloads; the SDK is bundled as scripts/puzle_reading.py. It requires Python and the requests library (documented). Nothing is written to the system beyond the client’s own config file when authorizing.
Credentials
The skill does not request environment variables or external credentials. It does require a user JWT obtained via device-auth; that token is saved to ~/.config/puzle/config.json (the code sets file permissions to 0600). The token handling is local (not placed into env vars or logs) per SKILL.md and code. Users should note the registry metadata did not declare this credential even though the SKILL.md explains the device-auth token flow.
Persistence & Privilege
always:false (default). The skill writes only its own config file (~/.config/puzle/config.json) to store the token and does not request system-wide privileges or modify other skills. Autonomous invocation is allowed by default but not combined with elevated privileges here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install puzle-read - After installation, invoke the skill by name or use
/puzle-read - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.5
No user-facing changes in this release.
- No file changes detected between previous and current versions.
v0.1.4
puzle-read version 0.1.4
- Documentation now covers CLI usage: explains how to use the SDK as a command-line tool in addition to a library.
- CLI commands are documented with syntax, available options, and usage examples.
- Prerequisites section expanded to clarify library and CLI invocation.
- No code changes detected; this release is documentation-only.
v0.1.3
Puzle Read Skill 0.1.2
- Updated metadata to clarify token acquisition, privacy, and publisher info.
- Removed support for environment variable token configuration; token is now managed only via device code flow and internal storage.
- Added explicit rules to never display or accept JWT tokens from users.
- Improved documentation on data handling and privacy, warning users not to upload sensitive data without Puzle policy review.
- Enhanced SKILL.md with clearer instructions for first-time setup and token flow.
v0.1.1
- Switched user authentication from manual JWT copy-paste to a secure device authorization code flow.
- Updated setup instructions to use https://read-web.puzle.com.cn/device-auth for easy login and code exchange.
- Added metadata documenting environment variables for token and API endpoint overrides.
- Clarified that tokens are exchanged and saved automatically after device code authorization—no token ever appears in chat.
- Improved security guidance regarding `PUZLE_BASE_URL` override.
- Updated all token expiration and renewal instructions to use the device authorization flow.
v0.0.1
Initial release of Puzle Read Skill: Seamlessly save, organize, and analyze web articles and documents with Puzle's intelligent reading library.
- Guides users through first-time setup and token configuration.
- Supports saving, summarizing, searching, and organizing articles, PDFs, and files.
- Handles authentication tokens, including expiration and renewal.
- Offers two modes: quick "save for later" and deeper content analysis.
- Step-by-step instructions for integration and token management included.
Metadata
Frequently Asked Questions
What is puzle-read?
Connect to Puzle Read — an intelligent reading workbench that helps users turn articles and documents into searchable personal knowledge. Save web articles (... It is an AI Agent Skill for Claude Code / OpenClaw, with 203 downloads so far.
How do I install puzle-read?
Run "/install puzle-read" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is puzle-read free?
Yes, puzle-read is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does puzle-read support?
puzle-read is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created puzle-read?
It is built and maintained by ZinkLu (@zinklu); the current version is v0.1.5.
More Skills