
Diagnose PDF
This skill should be used when a PDF made with bidi2pdf (CLI, Ruby API or bidi2pdf-rails) is blank, half empty, unstyled, missing images or
- Scripts
- None
- Platforms
- Claude Code, Codex, Cursor
- GitHub stars
- 58
- Last commit
- 15 days ago
- License
- MIT
- Listing updated
- today
When your agent uses it
This skill should be used when a PDF made with bidi2pdf (CLI, Ruby API or bidi2pdf-rails) is blank, half empty, unstyled, missing images or fonts, cut off, on the wrong number of pages, shows dates in the wrong format, or breaks words badly. A checklist from the cheapest check to the most expensive, using bidi2pdf diagnose.
From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.
What it can access
From a static check of its 1 file (4 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.
Install
This skill ships in the bidi2pdf plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):
/plugin marketplace add dieter-medium/bidi2pdf
/plugin install bidi2pdf@bidi2pdfOr copy only this skill to ~/.claude/skills/diagnose-pdf:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/dieter-medium/bidi2pdf.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/diagnose-pdf &&
cp -R "$tmp/claude-plugin/skills/diagnose-pdf" ~/.claude/skills/diagnose-pdf &&
rm -rf "$tmp"For one project only, put the folder in .claude/skills/diagnose-pdf inside it instead.
Copy the skill folder to ~/.agents/skills/diagnose-pdf to use it in every repository:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/dieter-medium/bidi2pdf.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/diagnose-pdf &&
cp -R "$tmp/claude-plugin/skills/diagnose-pdf" ~/.agents/skills/diagnose-pdf &&
rm -rf "$tmp"For one repository only, put the folder in .agents/skills/diagnose-pdf inside it instead.
Copy the skill folder to ~/.cursor/skills/diagnose-pdf to use it in every project:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/dieter-medium/bidi2pdf.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/diagnose-pdf &&
cp -R "$tmp/claude-plugin/skills/diagnose-pdf" ~/.cursor/skills/diagnose-pdf &&
rm -rf "$tmp"For one project only, put the folder in .cursor/skills/diagnose-pdf inside it instead.
Run in a terminal (add --scope workspace to install it for the current workspace only):
gemini skills install https://github.com/dieter-medium/bidi2pdf.git --path claude-plugin/skills/diagnose-pdfOr copy the folder to ~/.gemini/skills/diagnose-pdf yourself.
For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/diagnose-pdf:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/dieter-medium/bidi2pdf.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/diagnose-pdf &&
cp -R "$tmp/claude-plugin/skills/diagnose-pdf" ~/.copilot/skills/diagnose-pdf &&
rm -rf "$tmp"For one project only, put the folder in .github/skills/diagnose-pdf inside it instead.
Get the folder:
git clone --depth 1 https://github.com/dieter-medium/bidi2pdf.gitThen copy bidi2pdf/claude-plugin/skills/diagnose-pdf into your agent's skills folder as diagnose-pdf. Agents that support SKILL.md read one folder per skill.
Diagnose PDF FAQ
How do I install Diagnose PDF in Claude Code?
Copy the skill folder from GitHub to ~/.claude/skills/diagnose-pdf to use it in all your projects, or to .claude/skills/diagnose-pdf in one project. Or install the bidi2pdf plugin, which includes it: /plugin marketplace add dieter-medium/bidi2pdf, then /plugin install bidi2pdf@bidi2pdf.
Does Diagnose PDF run scripts?
No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.
Which AI agents can use Diagnose PDF?
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.
What are the best alternatives to Diagnose PDF?
The closest alternatives to Diagnose PDF are DOCX, XLSX, PDF, Drawio and Doc and modernize.
More from dieter-medium/bidi2pdf

This skill should be used when pages of a web site or app need screenshots for a design, UX or accessibility review - at phone and desktop w
- Open source
- 58 GitHub stars
- Browser automation

This skill should be used when a PDF needs more than one render call - waiting for an element, clicking something open, running a script, sw
- Open source
- 58 GitHub stars
- Files and documents

This skill should be used when writing or fixing RSpec specs that render PDFs or drive pages with bidi2pdf - asserting text, page count or i
- Open source
- 58 GitHub stars
- Files and documents

This skill should be used when bidi2pdf (or bidi2pdf-rails) should render in a shared Chrome container instead of a local browser - setting
- Open source
- 58 GitHub stars

This skill should be used when a web page, a URL or an HTML file has to become a PDF with bidi2pdf's command line, including a PDF of a page
- Open source
- 58 GitHub stars
- Files and documents
Alternatives to Diagnose PDF

DOCX
SkillUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files)
- 196K GitHub stars
- Files and documents

XLSX
SkillUse this skill any time a spreadsheet file is the primary input or output
- 196K GitHub stars
- Files and documents

PDF
SkillUse this skill whenever the user wants to do anything with PDF files
- 196K GitHub stars
- Files and documents

Drawio
SkillGenerate draw.io diagrams as .drawio files and export to PNG/SVG/PDF with embedded XML
- Open source
- 41.3K GitHub stars
- Files and documents

Doc and modernize
SkillTwo related workflows for a locally-cloned codebase, in one skill
- Open source
- 41.3K GitHub stars
- Files and documents

Export Markdown containing Mermaid code fences to Word (.docx) with embedded SVG diagrams and PNG fallbacks
- Open source
- 41.3K GitHub stars
- Files and documents


