47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
---
|
|
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:
|
|
|
|
```bash
|
|
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 `&`:
|
|
|
|
```powershell
|
|
& "/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.
|