Reference Implementation: LLM Prompts for Extraction and Classification¶

What it is¶

A collection of specialized prompt templates and schemas for Large Language Models (LLMs) to perform two core administrative tasks: Task Extraction (identifying actionable items from text) and Document Classification (categorizing documents into predefined buckets).

As of June 2026, these prompts are optimized for agents like Claude 4.8 and GPT-5.5 using Model Context Protocol (MCP) for schema validation.

What problem it solves¶

Managing a high volume of scanned documents requires significant cognitive effort to decide where each file belongs and what actions are required. Manual classification and task creation are major bottlenecks. These prompts turn raw OCR text into structured data, allowing for automated routing to Vikunja and Paperless-ngx.

Where it fits in the stack¶

This implementation sits in the Intelligent Processing Layer of the ingestion pipeline. It acts as the "brain" that interprets the output of OCR tools before passing structured instructions to the Task Management (Vikunja) or Document Storage (Paperless) layers.

Typical use cases¶

Inbox Zero for Paper: Automatically creating tasks in Vikunja for every bill, appointment, or school flyer scanned into the system.
Auto-Archiving: Categorizing documents (e.g., "Medical", "Finance", "School") to ensure they are stored with the correct tags and permissions in Paperless-ngx.
Meeting Minute Processing: Extracting action items, owners, and deadlines from meeting transcripts or voice memos.
Smart Inbox: Sorting documents automatically based on content rather than just filename or source directory.

Strengths¶

Multi-Purpose: Handles both the "what to do" (tasks) and "where to put it" (classification) in a single intelligent pipeline.
Priority Intelligence: Uses heuristic definitions to assign consistent priorities (High/Medium/Low) better than simple keyword matching.
JSON Standardized: Outputs data in a format ready for immediate API consumption or MCP tool invocation.
Local Model Friendly: Includes optimized prompts for Llama 4 Maverick and Qwen3-Coder-Next.

Limitations¶

Classification Ambiguity: Documents that span multiple categories (e.g., a "Medical Bill") may be classified inconsistently depending on model temperature.
Context Windows: Extremely large documents may need to be summarized or chunked before classification to stay within token limits.
OCR Sensitivity: Reliability is highly dependent on the quality of the upstream OCR (use Omni Tools VLM for best results).

When to use it¶

When you want to automate the transition from "digitized document" to "actionable task" in your productivity stack.
When building a "smart inbox" that sorts documents automatically based on semantic content.
For high-volume ingestion where manual metadata entry is not scalable.

When not to use it¶

For very high-security documents where LLM processing (if using a cloud provider) is restricted by privacy policies.
For simple document types where the category can be determined by the source (e.g., all files from the "Bank" folder are "Finance").
If the document volume is low enough that manual review is more cost-effective.

Getting started¶

1. Ingestion Setup¶

Configure your scanner or phone to upload PDFs to a "To-Process" folder. Use n8n to trigger the extraction pipeline when a new file arrives.

2. Model Selection¶

Use Claude 4.8 for high-precision extraction or a local Llama 4 Maverick instance for privacy-sensitive documents.

3. Integration¶

Map the JSON output to the Calendar Mapping Rules for date-based events or directly to the Vikunja API for tasks.

CLI examples¶

Test your extraction prompts using the following CLI commands.

# Extract tasks from an OCR text file using Claude Code
claude --prompt "$(cat task_extraction_prompt.txt)" --file ocr_text.txt

# Classify a document using a local Ollama instance
ollama run llama-4-maverick "Classify this text into [SCHOOL, ADMIN, FINANCE]: $(cat ocr_text.txt)"

# Validate extraction output against a schema
python3 scripts/validate_json.py --schema task_schema.json --data extraction_output.json

API examples¶

The prompts are designed for structured output.

Prompt Template: Task Extraction¶

Extract actionable tasks from the following text.

Text:
{{ocr_text}}

Return a list of JSON objects:
[
  {
    "task": "string",
    "due_date": "YYYY-MM-DD or null",
    "priority": "low/medium/high",
    "owner": "string (if mentioned)"
  }
]

Task Extraction JSON Schema¶

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "task": { "type": "string" },
      "due_date": { "type": ["string", "null"], "format": "date" },
      "priority": { "enum": ["low", "medium", "high"] },
      "owner": { "type": ["string", "null"] }
    },
    "required": ["task", "due_date", "priority", "owner"]
  }
}

Vikunja: The target system for extracted tasks.
Paperless-ngx: The target system for classified documents.
Date Extraction: Specialized prompt for precise date handling and timezone normalization.
Warranty Extraction: For specific "High" priority warranty deadlines and purchase dates.
HITL UI Design: The interface for manual review of extraction and classification results.
n8n Error Handling: Pattern for retrying failed or low-confidence extractions.
Document Preparation: Enhancing OCR quality for better classification.
n8n Service: The primary orchestrator for these LLM prompts.
MCP: Standardized protocol for model-tool interaction and schema management.

Sources / references¶

Contribution Metadata¶

Last reviewed: 2026-06-26
Confidence: high