PDF

PDF Skill

Required Environment Variables

• None required.

Invocation Contract

• Call run_skill_script with:
  • skill_name: pdf
  • script_name: one of check_fillable_fields, extract_form_field_info, fill_fillable_fields, convert_pdf_to_images, check_bounding_boxes, create_validation_image, fill_pdf_form_with_annotations
• These scripts are positional-argument based. Use args, not kwargs, for required parameters.

Scripts API

script_name: check_fillable_fields

• args: ["<input_pdf>"]
• Output: prints whether the PDF has fillable fields.

script_name: extract_form_field_info

• args: ["<input_pdf>", "<output_json>"]
• Output: JSON file with discovered fields and metadata.

script_name: fill_fillable_fields

• args: ["<input_pdf>", "<field_values_json>", "<output_pdf>"]
• Input contract: field values JSON structure documented in forms.md.

script_name: convert_pdf_to_images

• args: ["<input_pdf>", "<output_directory>"]
• Output: PNG images (one per page).

script_name: check_bounding_boxes

• args: ["<fields_json>"]
• Input contract: fields.json format documented in forms.md.
• Output: validation messages.

script_name: create_validation_image

• args: ["<page_number>", "<fields_json>", "<input_image>", "<output_image>"]
• Output: image with overlay boxes for inspection.

script_name: fill_pdf_form_with_annotations

• args: ["<input_pdf>", "<fields_json>", "<output_pdf>"]
• Input contract: annotated form JSON schema in forms.md.

run_skill_script Examples

• Extract field info:

{
  "skill_name": "pdf",
  "script_name": "extract_form_field_info",
  "args": ["form.pdf", "fields.json"]
}

• Fill fillable fields:

{
  "skill_name": "pdf",
  "script_name": "fill_fillable_fields",
  "args": ["form.pdf", "field_values.json", "filled.pdf"]
}

Direct CLI Examples

python agent_skills/skills/pdf/scripts/check_fillable_fields.py form.pdf
python agent_skills/skills/pdf/scripts/extract_form_field_info.py form.pdf fields.json
python agent_skills/skills/pdf/scripts/fill_fillable_fields.py form.pdf field_values.json filled.pdf
python agent_skills/skills/pdf/scripts/convert_pdf_to_images.py form.pdf out_images/
python agent_skills/skills/pdf/scripts/check_bounding_boxes.py fields.json
python agent_skills/skills/pdf/scripts/create_validation_image.py 1 fields.json out_images/page_1.png validated.png
python agent_skills/skills/pdf/scripts/fill_pdf_form_with_annotations.py form.pdf fields.json annotated.pdf

References

• forms.md: required JSON structures for form workflows.
• reference.md: additional PDF workflow guidance.