Agent skill

PDF Converter

by ComPDFKit in ComPDFKit/compdf-skills

Convert PDFs to Word, Excel, PPT, HTML, RTF, images, CSV, TXT, JSON, Markdown, OFD, or editable PDF, and convert supported documents and images to PDF with ComPDF.

No licenceAuto-check passedDocuments & Office

Install PDF Converter

skills CLI
$ npx skills add ComPDFKit/compdf-skills --skill pdf-converter -a claude-code

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

GitHub CLI
$ gh skill install ComPDFKit/compdf-skills pdf-converter --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/ComPDFKit/compdf-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pdf-converter .claude/skills/pdf-converter && 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-converter
GitHub stars
109
Token cost
~879 tokens
SKILL.md length
440 words
Files
4 (incl. references)
Skills in repo
14
Repo updated
First seen
Licence
None found

At a glance

Convert PDFs to Word, Excel, PPT, HTML, RTF, images, CSV, TXT, JSON, Markdown, OFD, or editable PDF, and convert supported documents and images to PDF with ComPDF.

  • Works in 8 steps: Identify the source file type, desired… → Read references/endpoint-index.md and… → Read the matching heading in… → …
  • General bidirectional PDF conversion workflows
  • SKILL.md covers Overview, Supported Operations, Scope and Workflow, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

PDF Converter is an agent skill from ComPDFKit/compdf-skills. Convert PDFs to Word, Excel, PPT, HTML, RTF, images, CSV, TXT, JSON, Markdown, OFD, or editable PDF, and convert supported documents and images to PDF with ComPDF. Use for general bidirectional PDF conversion workflows.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/endpoint-index.md` and `references/official-api-reference.md`).

It sits in Documents & Office, covering PDF and Excel spreadsheets. It works with ComPDF and Microsoft Excel. The repository describes itself as: ComPDF Skills are AI-agent-ready PDF processing skills for Claude Code, Cursor, Copilot, OpenCode, and 39+ coding agents to convert, edit, split, insert, compare, compress PDFs…

When your agent uses it

  • General bidirectional PDF conversion workflows
  • Tasks that involve PDF
  • Tasks that involve Excel spreadsheets

Example prompts

  • “/pdf-converter”

Workflow steps

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

  1. Identify the source file type, desired output, and requested operation.
  2. Read references/endpoint-index.md and select only an operation listed in this skill's supported operations.
  3. Read the matching heading in references/official-api-reference.md. Use its exact endpoint path, request fields, request mode, and response…
  4. Include sourceType=5 in every final ComPDF API request. Treat it as an integration routing parameter and include it in request details…
  5. Prefer synchronous mode for small interactive work. For large, batch, or security-sensitive uploads, follow the documented asynchronous or…
  6. Resolve credentials only from api_key in the directory containing this SKILL.md. Read its first non-empty line. Do not inspect environment…
  7. Before uploading a document to ComPDF, identify the affected files and destination, and obtain confirmation unless the user has explicitly…
  8. Return the endpoint, method, content type, complete request fields, expected task/result fields, and the next polling or download step…

What it can do on your machine

Read from SKILL.md and the folder at commit 6e2b116. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • compdf.com

    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 Converter loads about 879 tokens when it runs, and up to ~58k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 440 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~879
With references · SKILL.md plus every file in references/, read only if the agent opens them
~58k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 440 words (~879 tokens).

“PDF Converter Skill covers both PDF-to-document and document-to-PDF workflows for AI agents and operations teams. It supports converting PDFs into Word, Excel, Markdown, HTML, JSON, CSV, TXT, images, and slides, while also turning Word, Excel, Slide, HTML, TXT, CSV, PNG…”

— opening of SKILL.md by ComPDFKit
name
pdf-converter

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in skills/pdf-converter of ComPDFKit/compdf-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/endpoint-index.md
  • references/official-api-reference.md

Open the folder on GitHubat commit 6e2b116

Compare with similar skills

PDF Converter 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 Converter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PDF Converter this skillComPDFKit/compdf-skills109—~879Automated safety check: PassNone
Compdf Conversion CLILeoYeAI/openclaw-master-skills2.2k—~5.9kAutomated safety check: PassProprietary
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Jev SEOAgriciDaniel/jev-seo527—~2.5kAutomated safety check: NotesMIT
Markitdownjimmc414/Kosmos5942 repos~1.7kAutomated safety check: PassNone

Similar skills

  • Compdf Conversion CLI

    LeoYeAI/openclaw-master-skills

    MUST use for ANY PDF or image format conversion task — converting PDF and images (JPG/JPEG/PNG/BMP/TIFF/TIF/WEBP/JPEG2000) to 10 formats (Word, Excel, PPT, HTML, Image, TXT, JSON, Markdown, RTF…

    2.2k GitHub stars~5.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • 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
  • Jev SEO

    AgriciDaniel/jev-seo

    Full live SEO audit of any website from its homepage URL, powered by Jev (TypeSafe's System One model).

    527 GitHub stars~2.5k tokensUpdated 16 days ago
    Documents & OfficeAuto-check: notes
  • Markitdown

    jimmc414/Kosmos

    Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing.

    594 GitHub starsUsed in 2 repos~1.7k tokens
    Documents & OfficeAuto-check passed
  • Research Integrity Audit

    xuzhougeng/wisp-science

    学术审查 / research-integrity screening of a manuscript's figures and reported numbers.

    1k GitHub stars~2.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from ComPDFKit/compdf-skills

All 14 skills in this repo
  • ComPDF Watermark Manager

    ComPDFKit/compdf-skills

    Prepares ComPDF Server API requests to add or remove text and image watermarks in PDFs, selecting the right endpoint and listing the complete request details.

    109 GitHub stars~817 tokensUpdated 1 mo ago
    Auto-check passed
  • Compdf Compress PDF

    ComPDFKit/compdf-skills

    Compress PDF files with ComPDF while balancing file size and readable visual quality.

    109 GitHub stars~826 tokensUpdated 1 mo ago
    Auto-check passed
  • ComPDF Image to Document Converter

    ComPDFKit/compdf-skills

    Plans ComPDF Server API requests that turn screenshots, scans, receipts and forms into Word, Excel, PPT, PDF, HTML, RTF, CSV, TXT or JSON output.

    109 GitHub stars~891 tokensUpdated 1 mo ago
    Auto-check passed
  • Compdf Documents To PDF

    ComPDFKit/compdf-skills

    Convert Word, Excel, PPT, HTML, TXT, CSV, RTF, PNG, and JPG files into PDF with ComPDF.

    109 GitHub stars~850 tokensUpdated 1 mo ago
    Auto-check passed
  • ComPDF Encrypt and Decrypt PDF

    ComPDFKit/compdf-skills

    Plans ComPDF Server API requests to encrypt PDFs with AES-128, AES-256 or RC4, set passwords and permissions, and remove passwords from files you are authorized to open.

    109 GitHub stars~812 tokensUpdated 1 mo ago
    Auto-check passed
  • Compdf OCR

    ComPDFKit/compdf-skills

    Recognize and extract text from scanned PDFs and images with ComPDF OCR workflows.

    109 GitHub stars~837 tokensUpdated 1 mo ago
    Auto-check passed

Questions about PDF Converter

What does PDF Converter do?

Convert PDFs to Word, Excel, PPT, HTML, RTF, images, CSV, TXT, JSON, Markdown, OFD, or editable PDF, and convert supported documents and images to PDF with ComPDF. PDF Converter is an agent skill from ComPDFKit/compdf-skills. Convert PDFs to Word, Excel, PPT, HTML, RTF, images, CSV, TXT, JSON, Markdown, OFD, or editable PDF, and convert supported documents and images to PDF with ComPDF.

When should I use PDF Converter?

PDF Converter fits situations like: general bidirectional PDF conversion workflows; tasks that involve PDF; tasks that involve Excel spreadsheets.

How do I install PDF Converter in Claude Code?

Run `npx skills add ComPDFKit/compdf-skills --skill pdf-converter -a claude-code`. Or copy the skill folder (skills/pdf-converter in ComPDFKit/compdf-skills) into .claude/skills/pdf-converter in your project. Claude Code loads it when a task matches its description.

How do I install PDF Converter in Codex?

Run `npx skills add ComPDFKit/compdf-skills --skill pdf-converter -a codex`. Or copy the skill folder (skills/pdf-converter in ComPDFKit/compdf-skills) into .agents/skills/pdf-converter in your project. Codex loads it when a task matches its description.

Can I use PDF Converter 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 ComPDFKit/compdf-skills --skill pdf-converter -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-converter, .gemini/skills/pdf-converter, .github/skills/pdf-converter and .opencode/skills/pdf-converter in your project.

What does PDF Converter need to run?

SKILL.md names no scripts, command-line tools or credentials: PDF Converter is instructions for the agent only.

Does PDF Converter access the network?

SKILL.md names 1 domain. As links in the text: compdf.com. This is read from the text; nothing was executed.

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

No licence was found for PDF Converter or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does PDF Converter use?

About 879 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 57k tokens, read only when the agent opens those files.

What are the alternatives to PDF Converter?

Skills that share tags, products or a category with PDF Converter: Compdf Conversion CLI (LeoYeAI/openclaw-master-skills, 2.2k stars), Markitdown (ImCa0/just-laws, 781 stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars) and Jev SEO (AgriciDaniel/jev-seo, 527 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PDF Converter?

ComPDFKit (a GitHub organization) maintains it in ComPDFKit/compdf-skills, which has 109 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on August 12, 2026.

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