vault sync 04/09 12:20

copilot/skills/copilot-read-pdf/SKILL.md

@@ -0,0 +1,46 @@
+---
+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.