Skip to content
Skill

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

Install
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@bidi2pdf

Or 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.

Claude Code docs on skills

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.

Codex docs on skills

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.

Cursor docs on skills

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-pdf

Or copy the folder to ~/.gemini/skills/diagnose-pdf yourself.

Gemini CLI docs on skills

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.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/dieter-medium/bidi2pdf.git

Then 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.

The SKILL.md format

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

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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

  1. DOCX

    Skill

    Use 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
  2. XLSX

    Skill

    Use this skill any time a spreadsheet file is the primary input or output

    • 196K GitHub stars
    • Files and documents
  3. PDF

    Skill

    Use this skill whenever the user wants to do anything with PDF files

    • 196K GitHub stars
    • Files and documents
  4. Drawio

    Skill

    Generate draw.io diagrams as .drawio files and export to PNG/SVG/PDF with embedded XML

    • Open source
    • 41.3K GitHub stars
    • Files and documents
  5. Two related workflows for a locally-cloned codebase, in one skill

    • Open source
    • 41.3K GitHub stars
    • Files and documents
  6. 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