Agent skill

PDF Verification Check

by HKUDS in HKUDS/OpenSpace

Verify generated PDFs for integrity and page count using PyPDF2 before task completion.

MITAuto-check passedDocuments & Office

Install PDF Verification Check

skills CLI
$ npx skills add HKUDS/OpenSpace --skill pdf-verification-check -a claude-code

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

GitHub CLI
$ gh skill install HKUDS/OpenSpace pdf-verification-check --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/pdf-verification-check .claude/skills/pdf-verification-check && 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
pdf-verification-check
GitHub stars
7.8k
Token cost
~718 tokens
SKILL.md length
225 words
Files
2
Skills in repo
199
Repo updated
First seen
Licence
MIT

At a glance

Verify generated PDFs for integrity and page count using PyPDF2 before task completion.

  • Works in 4 steps: Identify Expected Outputs: List the file… → Run Verification Script: Use run_shell… → Validate Results: Ensure the script… → …
  • Tasks that involve PDF
  • SKILL.md covers When to Use, Verification Steps, Verification Script and Integration Example, plus 2 more sections
  • Calls python3 and pip

What it does

PDF Verification Check is an agent skill from HKUDS/OpenSpace. Verify generated PDFs for integrity and page count using PyPDF2 before task completion.

Its SKILL.md is about 720 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 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

  • “/pdf-verification-check”

Requirements

  • Python 3

Workflow steps

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

  1. Identify Expected Outputs: List the file paths and their expected page counts.
  2. Run Verification Script: Use run_shell to execute a Python script using PyPDF2.
  3. Validate Results: Ensure the script exits successfully and reports the correct page counts.
  4. Remediate: If verification fails, inspect the generation logic and regenerate.

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:

    • python3
    • 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

PDF Verification Check loads about 718 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 225 words of instructions outside code blocks.

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

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). 225 words, ~718 tokens.

Download SKILL.mdSave it as .claude/skills/pdf-verification-check/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pdf-verification-check
description
Verify generated PDFs for integrity and page count using PyPDF2 before task completion.

PDF Verification Check

Use this skill whenever your task involves generating PDF files. Do not declare task completion until you have programmatically verified that the PDFs exist, are not corrupted, and match the expected page counts.

When to Use

  • Immediately after generating one or more PDF files.
  • Before reporting success or moving to the next phase of a task.
  • When specific page counts are required (e.g., "1-page summary", "2-page listing").

Verification Steps

  1. Identify Expected Outputs: List the file paths and their expected page counts.
  2. Run Verification Script: Use run_shell to execute a Python script using PyPDF2.
  3. Validate Results: Ensure the script exits successfully and reports the correct page counts.
  4. Remediate: If verification fails, inspect the generation logic and regenerate.

Verification Script

Use the following Python snippet with run_shell to verify PDFs. Adjust the expected_pages dictionary to match your task requirements.

python
import sys
from PyPDF2 import PdfReader

def verify_pdfs(files):
    """
    files: dict mapping filepath to expected_page_count (or None if any count is ok)
    """
    all_valid = True
    for path, expected_count in files.items():
        try:
            reader = PdfReader(path)
            actual_count = len(reader.pages)
            
            if expected_count is not None and actual_count != expected_count:
                print(f"FAIL: {path} has {actual_count} pages, expected {expected_count}")
                all_valid = False
            else:
                print(f"OK: {path} has {actual_count} pages")
                
        except Exception as e:
            print(f"ERROR: Cannot read {path} - {str(e)}")
            all_valid = False
            
    return 0 if all_valid else 1

# Example usage - modify this map for your specific task
files_to_check = {
    "output/listing.pdf": 2,
    "output/map.pdf": 1
}

sys.exit(verify_pdfs(files_to_check))

Integration Example

When using run_shell, pass the script as a heredoc or save it temporarily:

bash
python3 -c "
import sys
from PyPDF2 import PdfReader
# ... insert logic here ...
"

Rules

  • Always Verify: Never assume a PDF generation tool succeeded without checking the output file.
  • Check Integrity: Successfully opening the file confirms it is not corrupted/empty.
  • Check Counts: Page count mismatches often indicate formatting errors or missing content.
  • Fail Fast: If verification fails, attempt to fix the generation code immediately rather than proceeding.

Dependencies

Ensure PyPDF2 is available in the environment. If not, install it first:

bash
pip install PyPDF2

© 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/pdf-verification-check of HKUDS/OpenSpace.

  • SKILL.md
  • .skill_id

Open the folder on GitHubat commit 3827781

Compare with similar skills

PDF Verification Check 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.

PDF Verification Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PDF Verification Check this skillHKUDS/OpenSpace7.8k—~718Automated safety check: PassMIT
PDFnuoyimanaituling/manus-x830—~985Automated safety check: PassNone
PDFeinverne/dotfiles12147 repos~1.8kAutomated safety check: PassProprietary
Reportlabjimmc414/Kosmos5951 repos~4.2kAutomated safety check: PassNone
PDFguyi-a/pi-ling106—~3.3kAutomated safety check: PassMIT
PDF ReadingWide-Moat/open-computer-use1261 repos~2.7kAutomated safety check: PassProprietary

Similar skills

  • PDF

    nuoyimanaituling/manus-x

    Process PDF files - extract text, read content, create PDFs, merge or split documents.

    830 GitHub stars~985 tokensUpdated 8 mo ago
    Documents & OfficeAuto-check passed
  • PDF

    einverne/dotfiles

    Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms.

    121 GitHub starsUsed in 47 repos~1.8k tokens
    Documents & OfficeAuto-check passed
  • Reportlab

    jimmc414/Kosmos

    PDF generation toolkit. An agent skill from jimmc414/Kosmos.

    595 GitHub starsUsed in 1 repo~4.2k tokens
    Documents & OfficeAuto-check passed
  • PDF

    guyi-a/pi-ling

    PDF 相关的所有操作:从零生成(reportlab / pypdf)、格式转化(md/html → PDF)、修改(合并 / 拆分 / 旋转 / 加水印 / 提图片 / 元数据)、读内容(pdfplumber / extractdocumenttext)、OCR 扫描件、加密解密。触发场景:用户说"生成 PDF" / "做份 PDF 简历" / "合并这几份 PDF" / "给 PDF…

    106 GitHub stars~3.3k tokensUpdated 23 days ago
    Documents & OfficeAuto-check passed
  • PDF Reading

    Wide-Moat/open-computer-use

    A skill your agent uses when you need to read, inspect, or extract content from PDF files — especially when file content is NOT in your context and you need to read it from disk.

    126 GitHub starsUsed in 1 repo~2.7k tokens
    Documents & OfficeAuto-check passed
  • PDF

    LeastBit/Claude_skills_zh-CN

    全面的 PDF 操作工具包,用于提取文本和表格、创建新 PDF、合并/拆分文档以及处理表单。当 Claude 需要填写 PDF 表单或以编程方式大规模处理、生成或分析 PDF 文档时使用。

    590 GitHub stars~1.5k tokensUpdated 8 mo 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 PDF Verification Check

What does PDF Verification Check do?

Verify generated PDFs for integrity and page count using PyPDF2 before task completion. PDF Verification Check is an agent skill from HKUDS/OpenSpace. Verify generated PDFs for integrity and page count using PyPDF2 before task completion.

When should I use PDF Verification Check?

PDF Verification Check fits situations like: tasks that involve PDF.

How do I install PDF Verification Check in Claude Code?

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

How do I install PDF Verification Check in Codex?

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

Can I use PDF Verification Check 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 pdf-verification-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pdf-verification-check, .gemini/skills/pdf-verification-check, .github/skills/pdf-verification-check and .opencode/skills/pdf-verification-check in your project.

What does PDF Verification Check need to run?

Going by SKILL.md and its folder, PDF Verification Check needs the command-line tools its instructions call (python3 and pip). Our summary lists: Python 3.

Does PDF Verification Check 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 PDF Verification Check 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 PDF Verification Check use?

PDF Verification Check 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 PDF Verification Check use?

About 718 tokens (SKILL.md is roughly 2.9k 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 PDF Verification Check?

Skills that share tags, products or a category with PDF Verification Check: PDF (nuoyimanaituling/manus-x, 830 stars), PDF (einverne/dotfiles, 121 stars), Reportlab (jimmc414/Kosmos, 595 stars) and PDF (guyi-a/pi-ling, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PDF Verification Check?

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.