← Back to Skills Marketplace
madmantim

paperless-ngx-tools

by madmantim · GitHub ↗ · v1.0.2
cross-platform ✓ Security Clean
2225
Downloads
3
Stars
3
Active Installs
3
Versions
Install in OpenClaw
/install paperless-ngx-tools
Description
Manage documents in Paperless-ngx - search, upload, tag, and retrieve.
Usage Guidance
This skill appears to do what it claims: run the included Node scripts to manage Paperless-ngx via its API. Before installing: 1) Ensure you have Node.js available locally (SKILL.md uses `node` but the registry entry didn't list it). 2) Only set PAPERLESS_URL to a trusted Paperless host and store PAPERLESS_TOKEN securely (the token gives API access to your documents). 3) Review the uploaded/download paths you use (the scripts will read local files for upload and write files for download). 4) Because the skill can be invoked by the agent, consider whether you want autonomous runs using that token; revoke/regenerate the token in Paperless if you later stop using the skill. If you need higher assurance, inspect the bundled scripts yourself (they are included) before running.
Capability Analysis
Type: OpenClaw Skill Name: paperless-ngx-tools Version: 1.0.2 The skill bundle is designed to interact with the Paperless-ngx API for document management. All Node.js scripts (`.mjs`) correctly utilize `PAPERLESS_URL` and `PAPERLESS_TOKEN` from environment variables to make authenticated API calls to the specified Paperless-ngx instance. File system operations (reading for upload, writing for download) are directly related to the skill's stated purpose and do not target sensitive system paths or execute arbitrary commands. The `SKILL.md` documentation provides clear instructions for using the skill and does not contain any prompt injection attempts or instructions for malicious behavior. No external dependencies, obfuscation, or unauthorized network/system access were identified.
Capability Assessment
Purpose & Capability
Name/description, API reference, and scripts all align with managing Paperless-ngx documents. One mismatch: the package includes NodeJS scripts and the SKILL.md shows commands like `node {baseDir}/scripts/...`, but the registry metadata lists no required binaries — it should declare `node` (or `nodejs`) as a required binary.
Instruction Scope
SKILL.md instructs the agent to call local scripts and document the two env vars. The scripts only access PAPERLESS_URL/PAPERLESS_TOKEN and the Paperless API, read/write local files for upload/download, and fetch metadata — all within the expected scope.
Install Mechanism
No install spec is provided (instruction + bundled scripts). No remote downloads or archive extraction are performed by the skill. This lowers installation risk.
Credentials
Only PAPERLESS_URL and PAPERLESS_TOKEN are required and the primary credential is PAPERLESS_TOKEN — appropriate and proportional for talking to a Paperless-ngx instance.
Persistence & Privilege
always: false and no special persistence or cross-skill/system configuration changes. The skill does perform file I/O (upload/download) as expected, but it does not request elevated or persistent privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install paperless-ngx-tools
  3. After installation, invoke the skill by name or use /paperless-ngx-tools
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Fix display name to match slug
v1.0.1
Fix display name to match slug
v1.0.0
Initial release - Node.js scripts for search, upload, download, tags, types, and correspondents
Metadata
Slug paperless-ngx-tools
Version 1.0.2
License
All-time Installs 4
Active Installs 3
Total Versions 3
Frequently Asked Questions

What is paperless-ngx-tools?

Manage documents in Paperless-ngx - search, upload, tag, and retrieve. It is an AI Agent Skill for Claude Code / OpenClaw, with 2225 downloads so far.

How do I install paperless-ngx-tools?

Run "/install paperless-ngx-tools" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is paperless-ngx-tools free?

Yes, paperless-ngx-tools is completely free (open-source). You can download, install and use it at no cost.

Which platforms does paperless-ngx-tools support?

paperless-ngx-tools is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created paperless-ngx-tools?

It is built and maintained by madmantim (@madmantim); the current version is v1.0.2.

💬 Comments