OpenParable
Skip to content
← Back to skills

PDF Form Processor

Documents
pdf-form-processor

PDF Form Processor is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

This skill should be used when the user asks to "fill PDF form", "extract PDF fields", "process PDF forms", "analyze PDF structure", or mentions working with fillable PDF documents.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/documents/pdf-form-processor/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pdf-form-processor, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

PDF Form Processor

Process fillable PDF forms: analyze fields, fill values, validate output.

Capabilities

  • Extract form field information
  • Fill form fields programmatically
  • Validate field mappings
  • Verify output documents

Quick Start

Extract Fields

python scripts/analyze_form.py input.pdf > fields.json

Fill Form

python scripts/fill_form.py input.pdf fields.json output.pdf

Workflow

Step 1: Analyze Form

Run analysis script to extract fields:

python scripts/analyze_form.py form.pdf

Output format:

{
  "field_name": {"type": "text", "x": 100, "y": 200},
  "signature": {"type": "sig", "x": 150, "y": 500}
}

Step 2: Create Field Mapping

Edit fields.json to add values:

{
  "field_name": {
    "type": "text",
    "value": "John Doe"
  }
}

Step 3: Validate Mapping

Check for errors before filling:

python scripts/validate_fields.py fields.json
# Returns: "OK" or lists issues

Step 4: Fill Form

Apply values to PDF:

python scripts/fill_form.py input.pdf fields.json output.pdf

Step 5: Verify Output

Check filled document:

python scripts/verify_output.py output.pdf

If verification fails, return to Step 2.

Progress Tracking

Task Progress:
- [ ] Step 1: Analyze form
- [ ] Step 2: Create field mapping
- [ ] Step 3: Validate mapping
- [ ] Step 4: Fill form
- [ ] Step 5: Verify output

Requirements

Install dependencies:

pip install pypdf pdfplumber

Additional Resources

Reference Files

  • references/field-types.md - Supported field types and properties
  • references/troubleshooting.md - Common issues and solutions

Scripts

  • scripts/analyze_form.py - Extract form fields
  • scripts/fill_form.py - Apply field values
  • scripts/validate_fields.py - Validate mappings
  • scripts/verify_output.py - Check output document