← Back to Skills Marketplace
Paperless-ngx
by
Oskar Stark
· GitHub ↗
· v1.0.0
2584
Downloads
4
Stars
8
Active Installs
1
Versions
Install in OpenClaw
/install paperless-ngx
Description
Interact with Paperless-ngx document management system via REST API. Use when users want to search, upload, download, organize documents, manage tags, correspondents, or document types in their Paperless-ngx instance.
Usage Guidance
This skill appears to do what it says (talk to a Paperless-ngx REST API), but there are two things to resolve before trusting it: (1) the SKILL.md requires PAPERLESS_URL and PAPERLESS_TOKEN but the registry metadata doesn't declare them — ask the publisher to correct the metadata so you can audit required secrets; (2) the API token grants powerful actions (upload, delete, bulk edits). Only provide a token with the minimum permissions needed, store it securely, and be prepared to revoke/rotate it if something unexpected happens. Because the source/homepage is unknown, prefer installing only if you can verify the publisher or obtain the skill's source/instructions from a trusted location. If possible, test with a read-only or limited account first rather than an admin token.
Capability Analysis
Type: OpenClaw Skill
Name: paperless-ngx
Version: 1.0.0
The skill bundle is designed to interact with the Paperless-ngx REST API, requiring `PAPERLESS_URL` and `PAPERLESS_TOKEN` environment variables. All `curl` commands demonstrated in `SKILL.md` are directly related to document management operations (search, upload, download, delete, metadata updates, tag/correspondent/document type management) against the user-configured Paperless-ngx instance. While it involves network calls and local file operations (for document upload/download), these are essential for the skill's stated purpose and show no evidence of malicious intent, data exfiltration to unauthorized endpoints, prompt injection against the agent, or other harmful behaviors.
Capability Assessment
Purpose & Capability
SKILL.md describes exactly the Paperless-ngx REST operations you'd expect (search, upload, download, metadata updates, delete, tags, correspondents, bulk operations). However, the skill's registry metadata lists no required environment variables or primary credential while SKILL.md explicitly requires PAPERLESS_URL and PAPERLESS_TOKEN — a metadata mismatch that prevents clear permission/credential auditing.
Instruction Scope
Runtime instructions are narrowly scoped to making HTTP requests to the user-supplied Paperless-ngx instance and to reading two environment variables (PAPERLESS_URL and PAPERLESS_TOKEN). There are no instructions to read unrelated files, other env vars, or to send data to external endpoints beyond the specified base URL.
Install Mechanism
No install spec and no code files (instruction-only). This is low-risk from an install perspective because nothing is written to disk or downloaded by the skill itself.
Credentials
Requesting an API token and base URL is appropriate for this functionality, but the skill does not declare these required env vars in the registry metadata. Also note the PAPERLESS_TOKEN, if provided, can permit sensitive actions (upload, delete, bulk edit). The token's broad privileges are proportional to the operations shown but warrant caution and least-privilege use.
Persistence & Privilege
The skill does not request permanent presence (always: false), has no install actions, and does not modify other skills or system-wide configuration. Normal autonomous invocation is allowed (platform default).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install paperless-ngx - After installation, invoke the skill by name or use
/paperless-ngx - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with document management, search, upload, download, tags, correspondents, and document types support.
Metadata
Frequently Asked Questions
What is Paperless-ngx?
Interact with Paperless-ngx document management system via REST API. Use when users want to search, upload, download, organize documents, manage tags, correspondents, or document types in their Paperless-ngx instance. It is an AI Agent Skill for Claude Code / OpenClaw, with 2584 downloads so far.
How do I install Paperless-ngx?
Run "/install paperless-ngx" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Paperless-ngx free?
Yes, Paperless-ngx is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Paperless-ngx support?
Paperless-ngx is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Paperless-ngx?
It is built and maintained by Oskar Stark (@oskarstark); the current version is v1.0.0.
More Skills