Agent skill

Reliable PDF Extraction Ac5f89

by HKUDS in HKUDS/OpenSpace

Extract PDF text content using shell tools or Python libraries when readfile PDF handler fails

MITAuto-check passedDocuments & Office

Install Reliable PDF Extraction Ac5f89

skills CLI
$ npx skills add HKUDS/OpenSpace --skill reliable-pdf-extraction-ac5f89 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUDS/OpenSpace reliable-pdf-extraction-ac5f89 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/benchmarks/gdpval/skills/reliable-pdf-extraction-ac5f89 .claude/skills/reliable-pdf-extraction-ac5f89 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reliable-pdf-extraction-ac5f89
GitHub stars
7.8k
Token cost
~704 tokens
SKILL.md length
193 words
Files
2
Skills in repo
199
Repo updated
First seen
Licence
MIT

At a glance

Extract PDF text content using shell tools or Python libraries when readfile PDF handler fails

  • Works in 4 steps: Check PDF exists and is readable → Extract text using pdftotext → If pdftotext fails, try Python fallback → …
  • Tasks that involve PDF
  • SKILL.md covers Problem, Solution, Methods and Workflow, plus 3 more sections
  • Calls pdftotext, apt-get and pip

What it does

Reliable PDF Extraction Ac5f89 is an agent skill from HKUDS/OpenSpace. Extract PDF text content using shell tools or Python libraries when readfile PDF handler fails

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Documents & Office, covering PDF. It works with Python and pypdf. The repository describes itself as: "OpenSpace: The Skill Management Layer for AI Agents" -- https://open-space.cloud/. The licence is MIT.

When your agent uses it

  • Tasks that involve PDF

Example prompts

  • “/reliable-pdf-extraction-ac5f89”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Check PDF exists and is readable
  2. Extract text using pdftotext
  3. If pdftotext fails, try Python fallback
  4. Verify extraction succeeded

What it can do on your machine

Read from SKILL.md and the folder at commit 3827781. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pdftotext
    • apt-get
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reliable PDF Extraction Ac5f89 loads about 704 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 193 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~704

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HKUDS/OpenSpace at commit 3827781, republished under its MIT licence (© HKUDS). 193 words, ~704 tokens.

Download SKILL.mdSave it as .claude/skills/reliable-pdf-extraction-ac5f89/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
reliable-pdf-extraction-ac5f89
description
Extract PDF text content using shell tools or Python libraries when read_file PDF handler fails

Reliable PDF Text Extraction

Problem

The read_file tool with filetype='pdf' can be unreliable for PDF text extraction. It may:

  • Return binary image data instead of text
  • Fail with errors on certain PDF structures
  • Lose formatting or structured content

Solution

Use run_shell with dedicated PDF extraction tools instead of relying on read_file for PDFs.

Methods

bash
pdftotext input.pdf output.txt

Or to extract to stdout:

bash
pdftotext input.pdf -

With layout preservation:

bash
pdftotext -layout input.pdf output.txt
Method 2: pdfinfo (Metadata)
bash
pdfinfo input.pdf

Useful for checking page count, dimensions, and PDF properties before extraction.

Method 3: Python with PyMuPDF (fitz)
python
import fitz  # PyMuPDF

doc = fitz.open("input.pdf")
text = ""
for page in doc:
    text += page.get_text()
doc.close()
Method 4: Python with pdfplumber (Tables)
python
import pdfplumber

with pdfplumber.open("input.pdf") as pdf:
    for page in pdf.pages:
        text = page.extract_text()
        tables = page.extract_tables()

Workflow

  1. Check PDF exists and is readable:

    bash
    pdfinfo input.pdf 2>/dev/null || echo "PDF not accessible"
  2. Extract text using pdftotext:

    bash
    pdftotext -layout input.pdf - > extracted_text.txt
  3. If pdftotext fails, try Python fallback:

    python
    import fitz
    doc = fitz.open("input.pdf")
    for i, page in enumerate(doc):
        print(f"--- Page {i+1} ---")
        print(page.get_text())
    doc.close()
  4. Verify extraction succeeded:

    • Check output is non-empty
    • Verify text is readable (not binary/garbled)
    • Confirm expected content is present

When to Use

ToolBest For
pdftotextFast, simple text extraction
pdftotext -layoutPreserving spacing/formatting
PyMuPDFComplex PDFs, programmatic access
pdfplumberTables and structured data

Example Integration

bash
# In your agent workflow, prefer this pattern:
result = run_shell(command="pdftotext document.pdf -", timeout=30)
if result.stdout and len(result.stdout.strip()) > 0:
    content = result.stdout
else:
    # Fallback to Python
    content = execute_python_to_extract_pdf("document.pdf")

Notes

  • Install tools if needed: apt-get install poppler-utils (for pdftotext/pdfinfo)
  • Python libraries: pip install pymupdf pdfplumber
  • Some PDFs are image-scanned and require OCR (Tesseract) instead
  • Always validate extracted content before proceeding with downstream tasks

© HKUDS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in benchmarks/gdpval/skills/reliable-pdf-extraction-ac5f89 of HKUDS/OpenSpace.

  • SKILL.md
  • .skill_id

Open the folder on GitHubat commit 3827781

Compare with similar skills

Reliable PDF Extraction Ac5f89 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reliable PDF Extraction Ac5f89 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reliable PDF Extraction Ac5f89 this skillHKUDS/OpenSpace7.8k—~704Automated safety check: PassMIT
PDF ToolkitXiaomiMiMo/MiMo-Code14k—~1.7kAutomated safety check: PassApache-2.0
PDF Generation, Forms and Extractionpipeshub-ai/pipeshub-ai3.8k—~2.9kAutomated safety check: PassApache-2.0
PDFNousResearch/hermes-agent253k—~3.1kAutomated safety check: PassMIT
PDF ExploreHughYau/AcademicForge2.6k—~3.1kAutomated safety check: PassApache-2.0
PDF ExploreJimLiu/science-skills2282 repos~3.6kAutomated safety check: PassApache-2.0

Similar skills

  • PDF Toolkit

    XiaomiMiMo/MiMo-Code

    Reads, transforms, composes and fills PDFs with Python scripts for extraction, merging, watermarking, encryption, OCR and form filling.

    14k GitHub stars~1.7k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Picks the right library for generating a new PDF, filling an existing PDF form, or extracting text and tables, defaulting to Node where possible.

    3.8k GitHub stars~2.9k tokensUpdated today
    Documents & OfficeAuto-check passed
  • PDF

    NousResearch/hermes-agent

    PDF files: create, read, merge, fill, OCR, edit text. An agent skill from NousResearch/hermes-agent.

    253k GitHub stars~3.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • PDF Explore

    HughYau/AcademicForge

    A skill your agent uses when the user has attached a PDF, paper, report, or other document and the answer needs content from more than one place in it: summarize the methods or any other section…

    2.6k GitHub stars~3.1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • PDF Explore

    JimLiu/science-skills

    A skill your agent uses when the user has attached a PDF, paper, report, or other document and the answer needs content from more than one place in it: summarize the methods or any other section…

    228 GitHub starsUsed in 2 repos~3.6k tokens
    Documents & OfficeAuto-check passed
  • PDF Reader

    espennilsen/pi

    Read and extract content from PDF files — text, tables, metadata, and images.

    122 GitHub stars~1.6k tokensUpdated 19 days ago
    Documents & OfficeAuto-check passed

More from HKUDS/OpenSpace

All 199 skills in this repo
  • Walks through producing a master audio track plus stems in Python, from checking a reference file and timing sections by BPM to effects, a zip archive and final verification.

    7.8k GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Handle cascading data retrieval tool failures by falling back to embedded knowledge generation

    7.8k GitHub stars~765 tokensUpdated 1 mo ago
    Auto-check passed
  • Gives an agent a workaround when its code-execution sandbox keeps failing: save the Python script to a file and run it through the shell instead.

    7.8k GitHub stars~588 tokensUpdated 1 mo ago
    Auto-check passed
  • A recovery routine for agents whose sandboxed code runner keeps failing: save the Python script to disk, then run it through the shell and read the output.

    7.8k GitHub stars~652 tokensUpdated 1 mo ago
    Auto-check passed
  • Fallback ladder for failed sandboxed code runs, plus the habit of fixing the working directory first so generated files land in the right place.

    7.8k GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Fallback workflow for executing Python code when executecodesandbox fails repeatedly

    7.8k GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Reliable PDF Extraction Ac5f89

What does Reliable PDF Extraction Ac5f89 do?

Extract PDF text content using shell tools or Python libraries when readfile PDF handler fails. Reliable PDF Extraction Ac5f89 is an agent skill from HKUDS/OpenSpace.

When should I use Reliable PDF Extraction Ac5f89?

Reliable PDF Extraction Ac5f89 fits situations like: tasks that involve PDF.

How do I install Reliable PDF Extraction Ac5f89 in Claude Code?

Run `npx skills add HKUDS/OpenSpace --skill reliable-pdf-extraction-ac5f89 -a claude-code`. Or copy the skill folder (benchmarks/gdpval/skills/reliable-pdf-extraction-ac5f89 in HKUDS/OpenSpace) into .claude/skills/reliable-pdf-extraction-ac5f89 in your project. Claude Code loads it when a task matches its description.

How do I install Reliable PDF Extraction Ac5f89 in Codex?

Run `npx skills add HKUDS/OpenSpace --skill reliable-pdf-extraction-ac5f89 -a codex`. Or copy the skill folder (benchmarks/gdpval/skills/reliable-pdf-extraction-ac5f89 in HKUDS/OpenSpace) into .agents/skills/reliable-pdf-extraction-ac5f89 in your project. Codex loads it when a task matches its description.

Can I use Reliable PDF Extraction Ac5f89 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/OpenSpace --skill reliable-pdf-extraction-ac5f89 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reliable-pdf-extraction-ac5f89, .gemini/skills/reliable-pdf-extraction-ac5f89, .github/skills/reliable-pdf-extraction-ac5f89 and .opencode/skills/reliable-pdf-extraction-ac5f89 in your project.

What does Reliable PDF Extraction Ac5f89 need to run?

Going by SKILL.md and its folder, Reliable PDF Extraction Ac5f89 needs the command-line tools its instructions call (pdftotext, apt-get and pip). Our summary lists: Python 3.

Does Reliable PDF Extraction Ac5f89 access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Reliable PDF Extraction Ac5f89 safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reliable PDF Extraction Ac5f89 use?

Reliable PDF Extraction Ac5f89 is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reliable PDF Extraction Ac5f89 use?

About 704 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reliable PDF Extraction Ac5f89?

Skills that share tags, products or a category with Reliable PDF Extraction Ac5f89: PDF Toolkit (XiaomiMiMo/MiMo-Code, 14k stars), PDF Generation, Forms and Extraction (pipeshub-ai/pipeshub-ai, 3.8k stars), PDF (NousResearch/hermes-agent, 253k stars) and PDF Explore (HughYau/AcademicForge, 2.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reliable PDF Extraction Ac5f89?

HKUDS (a GitHub organization) maintains it in HKUDS/OpenSpace, which has 7,754 GitHub stars. The repository holds 199 skills in this directory. The repository was last updated on August 12, 2026.

Source: HKUDS/OpenSpace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.