Skill: summarize-pdf-aloud

When to Use

Use this skill when the user asks to:

Find and read a PDF summary out loud
Speak a document summary
Have a PDF summarized verbally
Listen to a PDF summary
Read a PDF aloud
Summarize and speak a document

Input Parameters

Parameter	Required	Description	Example
`pdf_filename`	No	Optional: specific PDF filename to search for. If not provided, will search all PDFs in common locations	financial_statements.pdf
`search_directories`	No	Optional: comma-separated list of directories to search. Defaults to current directory, Desktop, and Downloads	$HOME/Documents,/Users/username/Desktop

Procedure

Search for PDF files in common directories: current directory, Desktop, and Downloads using ls and mdfind commands
Display found PDFs to user and ask which one to summarize if multiple results (use ask_user)
Extract text from the selected PDF using pdftotext command: pdftotext "{{pdf_path}}" - | head -500
Generate a concise summary of the extracted text (2-3 sentences capturing key information)
Use the 'say' command to read the summary aloud: say "{{summary_text}}"
Report completion status to user with the summary text provided

Reference Commands

Commands from a successful execution (adapt to actual inputs):

ls -la *.pdf 2>/dev/null || ls -la ~/Desktop/*.pdf 2>/dev/null | head -5 || ls -la ~/Downloads/*.pdf 2>/dev/null | head -5
mdfind -name .pdf 2>/dev/null | head -10
pdftotext "$HOME/Downloads/240630_Avenue_Bank_Limited_Financial_Statements.pdf" - 2>/dev/null | head -500
say "Avenue Bank Limited Annual Report for June 30, 2024. This Australian digital bank reported an 8.6 million dollar loss, an improvement from 9.5 million in 2023. The bank generated 556 thousand in net interest income and invested heavily in IT infrastructure and staff. CEO Peita Piper led the bank from ideation through full licensing and market launch."

Replace {{PLACEHOLDER}} values with actual credentials from the key store.

Example

Example requests that trigger this skill:

find a PDF on my computer and say out loud the summary of the document