| name | copilot-read-pdf |
| description | Extract the full text of a PDF as Markdown using Copilot Plus. Use when the user wants to read, summarize, or quote a PDF file (in the vault or an absolute path). Requires an active Copilot Plus license. |
| license | Copilot Plus |
| metadata | {"copilot-enabled-agents":"claude, codex, opencode","copilot-builtin-version":"6"} |
Copilot read PDF
Convert a PDF file to Markdown text through Copilot Plus so you can read,
summarize, or quote it.
How to run
Find the absolute path to this SKILL.md file on disk, then run the script next
to it that matches the operating system. No extra runtime is needed — sh
(macOS/Linux) and cmd/PowerShell (Windows) are always present.
On macOS or Linux:
sh "/absolute/path/to/this/skill/directory/read-pdf.sh" "<path-to-file.pdf>"
On Windows, run the .cmd wrapper. In PowerShell you must prefix it with the
call operator & (PowerShell treats a quoted path on its own as a string and
won't run it); from cmd, run the quoted path without the &:
& "/absolute/path/to/this/skill/directory/read-pdf.cmd" "<path-to-file.pdf>"
Pass an absolute path to the PDF file.
Both print the result to stdout.
If Copilot Plus is not active
If the script exits saying Copilot Plus is unavailable, do NOT retry it. Do what
the message says: fall back to your own equivalent built-in capability to handle
the request when you have one (otherwise tell the user it's unavailable) — never
refuse or block the user. Only mention upgrading or renewing Copilot Plus when
the script's message explicitly invites it, and keep any such note short and
friendly.
