← Back to Skills Marketplace
Paperless
by
NickChristensen
· GitHub ↗
· v1.1.0
2856
Downloads
1
Stars
14
Active Installs
3
Versions
Install in OpenClaw
/install paperless
Description
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
Usage Guidance
This skill looks coherent for controlling Paperless-NGX via the ppls CLI, but before installing: 1) Verify the npm package identity and maintainer (check the GitHub repo and package contents) to ensure you’re installing the legitimate @nickchristensen/ppls package. 2) Prefer installing without -g (or use a container/venv) if you want to limit global code execution, and avoid running npm as root. 3) Confirm where ppls stores the configured token (config file) and protect that file (restrict filesystem permissions); consider a least-privilege API token for Paperless. 4) Double-check the registry metadata mismatch (top-level metadata showed no required env vars/bins while SKILL.md does) — treat that as a packaging issue to clarify with the publisher. 5) If you cannot vet the package, consider manually invoking Paperless-NGX API calls or using a known trusted client instead.
Capability Analysis
Type: OpenClaw Skill
Name: paperless
Version: 1.1.0
The skill bundle is classified as benign. The `SKILL.md` file clearly defines the purpose of interacting with Paperless-NGX via the `ppls` CLI. It requires `PPLS_HOSTNAME` and `PPLS_TOKEN` environment variables, which are necessary for its stated functionality and are not exfiltrated. The installation instructions specify a known npm package (`@nickchristensen/ppls`), and all command examples are legitimate operations for a document management system, including downloading files to the user's `~/Downloads` directory. There is no evidence of malicious prompt injection, data exfiltration, unauthorized execution, or persistence mechanisms.
Capability Assessment
Purpose & Capability
The SKILL.md instructions and description match: they drive the ppls CLI to interact with Paperless-NGX (search, download, upload, metadata). However, registry-level metadata provided to you earlier shows no required binaries or env vars while the SKILL.md includes metadata that requires the ppls binary and env vars (PPLS_HOSTNAME, PPLS_TOKEN). This is likely a packaging/metadata omission rather than a functional mismatch, but it is an inconsistency you should be aware of.
Instruction Scope
Runtime instructions are narrowly scoped to installing/configuring/running the ppls CLI and using it to query and manage documents on a Paperless-NGX host. The doc tells the agent to run ppls commands and set hostname/token; it does not instruct reading unrelated files or exfiltrating data to third-party endpoints.
Install Mechanism
The SKILL.md recommends installing @nickchristensen/ppls via npm (global install). This is a common, expected mechanism for a CLI wrapper but is higher-risk than an instruction-only skill because it executes third-party code from npm. The referenced GitHub project exists (https://github.com/NickChristensen/ppls), which reduces but does not eliminate risk; you should review the package and prefer a trusted install method.
Credentials
The only credentials/configuration the skill needs (per SKILL.md metadata) are the Paperless hostname and API token (PPLS_HOSTNAME, PPLS_TOKEN), which are proportional to its purpose. No unrelated secrets or multiple service credentials are requested. Note again the registry metadata omitted these env requirements.
Persistence & Privilege
The skill does not request always:true, does not demand persistent elevated privileges, and does not attempt to change other skills' configurations. It appears to be an ordinary user-invocable skill with no special platform privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install paperless - After installation, invoke the skill by name or use
/paperless - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Updated docs with v1.2.0 CLI features: date filters, tag/correspondent/document-type filters, repeatable args
v1.0.1
Added metadata: requires ppls binary with install instructions
v1.0.0
Initial release - search, retrieve, upload, and organize documents via ppls CLI
Metadata
Frequently Asked Questions
What is Paperless?
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents. It is an AI Agent Skill for Claude Code / OpenClaw, with 2856 downloads so far.
How do I install Paperless?
Run "/install paperless" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Paperless free?
Yes, Paperless is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Paperless support?
Paperless is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Paperless?
It is built and maintained by NickChristensen (@nickchristensen); the current version is v1.1.0.
More Skills