AgentSkillsCN

paperless

在 Paperless-ngx 文档管理系统中搜索并管理各类文档。当用户询问有关文档、发票、收据、税务表格、账单等信息，或希望检索其文档库时，可使用此功能。

SKILL.md
--- frontmatter
name: paperless
description: Search and manage documents in Paperless-ngx document management system. Use when the user asks about documents, invoices, receipts, tax forms, bills, or wants to search their document library.
allowed-tools: Bash, Read

Paperless-ngx

Interact with Paperless-ngx document management system via CLI.

Setup

Environment: ~/.secrets.env (PAPERLESS_URL, PAPERLESS_TOKEN) - loaded by wrapper.

CLI Discovery

Run paperless-cli --help to see available commands. Run paperless-cli <command> --help for detailed usage of any command.

Capabilities

The CLI supports:

  • •Search: Full-text search with filters (date ranges, tags, correspondents)
  • •Browse: List recent documents, inbox items
  • •Read: Get document details and extracted text content
  • •Organize: Add/remove tags, edit metadata (title, correspondent, type)
  • •Find related: Discover similar documents
  • •Download: Save original files locally
  • •Metadata: List tags, correspondents, document types, stats

Workflow

  1. •Search or list to find documents
  2. •Get document by ID to read full content
  3. •Add/remove tags to organize
  4. •Find similar documents for related items
  5. •Download originals when needed

Notes

  • •Flags must come BEFORE positional arguments
  • •Document IDs are integers returned from search/list results