name: pdf version: "1.0" description: Extract text from PDF documents entry: script: scripts/main.py class: PdfSkill triggers: extensions:

• ".pdf"

intents:

• "pdf"
• "research paper"

requires:

• pypdf
• pdfminer.six

author: axoviq.com license: AGPL-3.0-or-later

PDF Skill

Extracts text from PDF files using pypdf as the primary parser, with pdfminer.six as a fallback for CJK fonts that pypdf cannot decode (detected when pypdf yields fewer than 50 characters per page on average).

Setup

pip install pypdf pdfminer.six

Standalone usage

import asyncio
from synthadoc.skills.pdf.scripts.main import PdfSkill
skill = PdfSkill()
async def main():
    result = await skill.extract("/path/to/paper.pdf")
    print(result.text)          # extracted text from all pages
    print(result.metadata)      # {"pages": N, "cjk_fallback": bool, ...}
asyncio.run(main())

When this skill is used

• Source path ends with .pdf
• User intent contains: pdf, research paper

Scripts

• scripts/main.py — PdfSkill class

References

• references/cjk-notes.md — notes on CJK font handling