← Back to Skills Marketplace
nickchristensen

Paperless

by NickChristensen · GitHub ↗ · v1.1.0
cross-platform ✓ Security Clean
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
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install paperless
  3. After installation, invoke the skill by name or use /paperless
  4. 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
Slug paperless
Version 1.1.0
License
All-time Installs 14
Active Installs 14
Total Versions 3
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.

💬 Comments