pdf

PDF (OpenAI)

pdf is OpenAI's open-source agent skill for making and reviewing PDF files: the agent builds them with Python libraries, renders each page to an image and checks the layout before delivering.

Checked by CookiesForAI on : license and last change of the skill re-read from GitHub.

Written by

Install PDF (OpenAI)

Install the skill with the skills CLI

Terminal
npx skills add openai/skills --skill pdf

Or, inside Codex, use the built-in skill installer

Agent chat
$skill-installer pdf

Restart Codex after installing so it picks up the new skill.

Or paste this into your coding agent: Install the agent skill pdf from github.com/openai/skills. Checked by CookiesForAI on : license and last change of the skill re-read from GitHub. A skill can include scripts that run on your computer, so read its source first.

What PDF (OpenAI) does

The PDF skill from OpenAI's skills catalog tells an agent how to handle PDF files where layout matters. For new documents it uses the reportlab Python library; for reading text and running quick checks it uses pdfplumber or pypdf, while warning that text extraction says nothing reliable about how the page looks.

Its main rule is visual review. After every meaningful change, the agent renders pages to PNG images with Poppler's pdftoppm and inspects them for clipped text, overlapping elements, broken tables, black squares or unreadable characters. It is told not to deliver until the latest render shows no defects, and to check headers, footers and page numbers.

The skill also fixes housekeeping: intermediate files go in tmp/pdfs and final files in output/pdf, with stable descriptive names. If a dependency cannot be installed, the agent is told to say which one is missing and how to install it, rather than carry on without checking the output.

When to use PDF (OpenAI)

  • You want an agent to produce a report or invoice as a PDF that looks right on every page.
  • You need to check a generated PDF for clipped text or broken tables before sending it.
  • You want text pulled out of a PDF for a quick check.
  • You want an open-licensed PDF skill you can copy and adapt.

When to pick something else

  • Filling PDF forms, splitting or merging files, or OCR on scans: the skill does not cover them. Anthropic's PDF skill does, and it is Apache-2.0 too.

What PDF (OpenAI) needs

  • Python with reportlab, pdfplumber and pypdf
  • Poppler (pdftoppm) for rendering pages to images

Which agents PDF (OpenAI) works in

OpenAI documents PDF (OpenAI) for Codex, Any agent that reads SKILL.md files, through the skills CLI. The open skills CLI also installs it into 78 agents, including Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode (we listed it with the CLI on ). See where each agent looks for skills.

OpenAI marked openai/skills deprecated on and points to its openai/plugins repository for current Codex skills. This copy still installs, but may not get updates.

We also list this company's other pages: OpenAI Codex coding tool.

PDF (OpenAI) license

PDF (OpenAI) is published under Apache-2.0. The skill folder carries its own Apache-2.0 LICENSE.txt, so you may use, change and share it, including at work. GitHub shows no license for the repository as a whole because each skill has its own.

Questions people ask

Is OpenAI's skills repository still maintained?

Its README has marked it deprecated since . OpenAI now points to the openai/plugins repository for Codex skills and plugins. Skills in openai/skills still install as of , but new work happens elsewhere.

Can I use OpenAI's PDF skill outside Codex?

Yes. Its folder has an Apache-2.0 license, and the skills CLI listed it for install on . It only needs Python and Poppler, nothing specific to Codex.

More from OpenAI

Lists that include pdf