Agent skill

PDF Verification CLI

Verify PDF page count and content using command-line tools when Python libraries unavailable

Install PDF Verification CLI

skills CLI

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

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

GitHub CLI

$ gh skill install HKUDS/OpenSpace pdf-verification-cli --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-cli .claude/skills/pdf-verification-cli && 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/

Paste into Claude Code

Install the "pdf-verification-cli" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pdf-verification-cli into .claude/skills/pdf-verification-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-verification-cli", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pdf-verification-cli

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pdf-verification-cli -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pdf-verification-cli --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .agents/skills && cp -r skills-src/benchmarks/gdpval/skills/pdf-verification-cli .agents/skills/pdf-verification-cli && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "pdf-verification-cli" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pdf-verification-cli into .agents/skills/pdf-verification-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-verification-cli", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pdf-verification-cli -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pdf-verification-cli --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/benchmarks/gdpval/skills/pdf-verification-cli .cursor/skills/pdf-verification-cli && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "pdf-verification-cli" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pdf-verification-cli into .cursor/skills/pdf-verification-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-verification-cli", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/HKUDS/OpenSpace.git --path benchmarks/gdpval/skills/pdf-verification-cli

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pdf-verification-cli -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pdf-verification-cli --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/benchmarks/gdpval/skills/pdf-verification-cli .gemini/skills/pdf-verification-cli && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "pdf-verification-cli" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pdf-verification-cli into .gemini/skills/pdf-verification-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-verification-cli", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pdf-verification-cli

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pdf-verification-cli -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .github/skills && cp -r skills-src/benchmarks/gdpval/skills/pdf-verification-cli .github/skills/pdf-verification-cli && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "pdf-verification-cli" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pdf-verification-cli into .github/skills/pdf-verification-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-verification-cli", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pdf-verification-cli -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pdf-verification-cli --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/benchmarks/gdpval/skills/pdf-verification-cli .opencode/skills/pdf-verification-cli && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "pdf-verification-cli" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pdf-verification-cli into .opencode/skills/pdf-verification-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-verification-cli", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: pdf-verification-cli
GitHub stars: 7.7k
Token cost: ~1.3k tokens
SKILL.md length: 312 words
Files: 2
Skills in repo: 199
Repo updated: Aug 12, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Verify PDF page count and content using command-line tools when Python libraries unavailable

Works in 6 steps: pdfinfo - Extract PDF Metadata → pdftotext - Extract Text Content → Check Tool Availability → …
Tasks that involve PDF
SKILL.md covers When to Use This Skill, Core Tools, Verification Workflow and Python Integration Example, plus 3 more sections
Calls pdftotext, apt-get and yum

What it does

PDF Verification CLI is an agent skill from HKUDS/OpenSpace. Verify PDF page count and content using command-line tools when Python libraries unavailable

Its SKILL.md is about 1.3k 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. 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-cli”

Requirements

Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

pdfinfo - Extract PDF Metadata
pdftotext - Extract Text Content
Check Tool Availability
Install if Needed
Verify PDF Properties
Verify PDF Content

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
- yum
- dnf
- brew
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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 CLI loads about 1.3k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 312 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: ~1.3k

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). 312 words, ~1,283 tokens.

Download SKILL.mdSave it as .claude/skills/pdf-verification-cli/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: pdf-verification-cli
description: Verify PDF page count and content using command-line tools when Python libraries unavailable

PDF Verification with Command-Line Tools

When verifying PDF files during task execution, Python libraries like PyPDF2 may not be available in the environment. This skill provides a reliable alternative using standard command-line tools from the poppler-utils package.

When to Use This Skill

Need to verify PDF page count
Need to inspect PDF text content
PyPDF2 or similar Python PDF libraries are unavailable
Working in minimal/containerized environments

Core Tools

1. `pdfinfo` - Extract PDF Metadata

Use pdfinfo to get page count and other metadata:

bash

# Get full PDF info
pdfinfo document.pdf

# Get only page count
pdfinfo document.pdf | grep Pages

# Extract page count as a number
pdfinfo document.pdf | grep Pages | awk '{print $2}'

Key metadata fields:

Pages: Number of pages in the PDF
Title: Document title
Author: Document author
Creator: Application that created the PDF
Producer: Application that processed the PDF
CreationDate: When the PDF was created
ModDate: Last modification date

2. `pdftotext` - Extract Text Content

Use pdftotext to inspect the actual content of the PDF:

bash

# Extract all text to stdout
pdftotext document.pdf -

# Extract text to a file
pdftotext document.pdf output.txt

# Extract text from specific page range
pdftotext -f 1 -l 3 document.pdf output.txt

# Preserve layout (rough formatting)
pdftotext -layout document.pdf output.txt

Verification Workflow

Step 1: Check Tool Availability

bash

# Check if tools are installed
which pdfinfo
which pdftotext

# Or test with --help
pdfinfo --help 2>&1 | head -1

Step 2: Install if Needed

bash

# Debian/Ubuntu
apt-get update && apt-get install -y poppler-utils

# RHEL/CentOS/Fedora
yum install -y poppler-utils
# or
dnf install -y poppler-utils

# macOS (with Homebrew)
brew install poppler

Step 3: Verify PDF Properties

bash

# Verify page count matches expected
EXPECTED_PAGES=4
ACTUAL_PAGES=$(pdfinfo document.pdf | grep Pages | awk '{print $2}')

if [ "$ACTUAL_PAGES" -eq "$EXPECTED_PAGES" ]; then
    echo "✓ Page count verified: $ACTUAL_PAGES pages"
else
    echo "✗ Page count mismatch: expected $EXPECTED_PAGES, got $ACTUAL_PAGES"
fi

Step 4: Verify PDF Content

bash

# Check for required sections/content
pdftotext document.pdf - | grep -i "checklist" && echo "✓ Contains checklist section"
pdftotext document.pdf - | grep -i "references" && echo "✓ Contains references section"

# Count occurrences of key terms
pdftotext document.pdf - | grep -ci "assessment"  # Case-insensitive count

Python Integration Example

python

import subprocess

def get_pdf_page_count(pdf_path):
    """Get page count using pdfinfo"""
    result = subprocess.run(
        ['pdfinfo', pdf_path],
        capture_output=True,
        text=True
    )
    for line in result.stdout.split('\n'):
        if line.startswith('Pages:'):
            return int(line.split(':')[1].strip())
    return None

def extract_pdf_text(pdf_path):
    """Extract all text from PDF using pdftotext"""
    result = subprocess.run(
        ['pdftotext', pdf_path, '-'],
        capture_output=True,
        text=True
    )
    return result.stdout

def verify_pdf(pdf_path, expected_pages, required_terms):
    """Verify PDF has expected page count and contains required terms"""
    # Check page count
    pages = get_pdf_page_count(pdf_path)
    if pages != expected_pages:
        return False, f"Expected {expected_pages} pages, got {pages}"
    
    # Check content
    text = extract_pdf_text(pdf_path).lower()
    missing = [term for term in required_terms if term.lower() not in text]
    
    if missing:
        return False, f"Missing terms: {missing}"
    
    return True, "PDF verification passed"

Common Use Cases

Task	Command
Count pages	`pdfinfo file.pdf \| grep Pages`
Check if PDF has text	`pdftotext file.pdf - \| head -5`
Search for keyword	`pdftotext file.pdf - \| grep -i "keyword"`
Extract first page	`pdftotext -f 1 -l 1 file.pdf out.txt`
Get PDF title	`pdfinfo file.pdf \| grep Title`

Troubleshooting

pdfinfo: command not found

Install poppler-utils (see Step 2 above)
Ensure PATH includes the installation directory

pdftotext returns empty output

PDF may be image-only (scanned) - requires OCR
PDF may be encrypted/password-protected
Try pdftotext -layout for better text extraction

Page count seems wrong

Some PDFs have blank pages counted
Verify with pdftotext to see actual content per page

Best Practices

Always verify both structure and content - Page count alone doesn't guarantee content quality
Use case-insensitive searches - Content may vary in capitalization
Handle errors gracefully - Tools may fail on corrupted or encrypted PDFs
Combine with file existence checks - Verify PDF exists before running tools

Files

SKILL.md and 1 other file in benchmarks/gdpval/skills/pdf-verification-cli of HKUDS/OpenSpace.

SKILL.md
.skill_id

Open the folder on GitHubat commit 3827781

Compare with similar skills

PDF Verification CLI 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 CLI compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
PDF Verification CLI this skillHKUDS/OpenSpace	7.7k	—	~1.3k	Automated safety check: Pass	MIT	1 mo ago
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences	274	2 repos	~2.7k	Automated safety check: Pass	Apache-2.0	6 days ago
Software Certificate SkillIvanCodesDev/software-certificate-skill	156	—	~1.6k	Automated safety check: Pass	MIT	1 mo ago
Doc Cleanernotoriouslab/doc-cleaner	309	—	~712	Automated safety check: Pass	MIT	1 mo ago
MineruNebutra/MinerU-Skill	122	—	~504	Automated safety check: Pass	MIT	13 days ago
Office To Mdshuyu-labs/WebCode	278	—	~1k	Automated safety check: Notes	Custom licence	3 mo ago

Similar skills

Instrument Data To Allotrope
aws-samples/amazon-bedrock-agents-healthcare-lifesciences
Official
Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.
274 GitHub starsUsed in 2 repos~2.7k tokens
Documents & OfficeAuto-check passed
Software Certificate Skill
IvanCodesDev/software-certificate-skill
面向普通用户，从真实软件项目全自动生成中国软件著作权申请资料：一次收集登记事实，自动分析业务、选择可追溯源码、取得真实界面证据，生成申请表信息、规范黑白灰操作手册、代码前后30页或全部材料及真实 DOCX/PDF；内部验证、渲染、哈希与备份只进入系统临时运行区，项目最终仅保留正式资料。适配 Codex、Claude…
156 GitHub stars~1.6k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed
Doc Cleaner
notoriouslab/doc-cleaner
Convert PDF, DOCX, XLSX, and text files to clean, structured Markdown.
309 GitHub stars~712 tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed
Mineru
Nebutra/MinerU-Skill
An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.
122 GitHub stars~504 tokensUpdated 13 days ago
Documents & OfficeAuto-check passed
Office To Md
shuyu-labs/WebCode
Convert Office documents (Word, Excel, PowerPoint, PDF) to Markdown format.
278 GitHub stars~1k tokensUpdated 3 mo ago
Documents & OfficeAuto-check: notes
Cc Streaming Export Safety
doccker/cc-use-exp
当实现用户驱动的大文件导出或批量序列化（Excel/CSV/JSON/JSONL/PDF，数据量未知或超过 1 万行/10 MB）时触发；普通小文件下载、静态资源下载、非导出 Writer/Report 类不触发。防止 OOM、临时文件残留、同步导出阻塞 HTTP 线程和表格公式注入。
1.1k GitHub stars~2.2k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed

Questions about PDF Verification CLI

What does PDF Verification CLI do?

Verify PDF page count and content using command-line tools when Python libraries unavailable. PDF Verification CLI is an agent skill from HKUDS/OpenSpace.

When should I use PDF Verification CLI?

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

How do I install PDF Verification CLI in Claude Code?

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

How do I install PDF Verification CLI in Codex?

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

Can I use PDF Verification CLI 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-cli -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-cli, .gemini/skills/pdf-verification-cli, .github/skills/pdf-verification-cli and .opencode/skills/pdf-verification-cli in your project.

What does PDF Verification CLI need to run?

Going by SKILL.md and its folder, PDF Verification CLI needs the command-line tools its instructions call (pdftotext, apt-get, yum, dnf and brew). Our summary lists: Python 3.

Does PDF Verification CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

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

About 1.3k tokens (SKILL.md is roughly 5.1k 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 CLI?

Skills that share tags, products or a category with PDF Verification CLI: Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Software Certificate Skill (IvanCodesDev/software-certificate-skill, 156 stars), Doc Cleaner (notoriouslab/doc-cleaner, 309 stars) and Mineru (Nebutra/MinerU-Skill, 122 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PDF Verification CLI?

HKUDS (a GitHub organization) maintains it in HKUDS/OpenSpace, which has 7,743 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.

Install PDF Verification CLI

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

PDF Verification with Command-Line Tools

When to Use This Skill

Core Tools

1. pdfinfo - Extract PDF Metadata

2. pdftotext - Extract Text Content

Verification Workflow

Step 1: Check Tool Availability

Step 2: Install if Needed

Step 3: Verify PDF Properties

Step 4: Verify PDF Content

Python Integration Example

Common Use Cases

Troubleshooting

Best Practices

Files

Compare with similar skills

Similar skills

More from HKUDS/OpenSpace

Related

Questions about PDF Verification CLI

1. `pdfinfo` - Extract PDF Metadata

2. `pdftotext` - Extract Text Content