[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6KFSXFCMV3NV0X0GFZNEQ2D":3,"skill-same:01M6KFSXFCMV3NV0X0GFZNEQ2D":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":14,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":48,"ownerDescription":49,"updatedAt":50,"install":51,"resources":64},"01M6KFSXFCMV3NV0X0GFZNEQ2D","pdftotext-fallback",null,"Recover PDF text extraction when read_file returns binary data by using pdftotext via shell","xyliu-cs\u002FOpenSpace-GDPval","xyliu-cs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F89236536?v=4","01M6KF8Z1V4TXS86CKSH48BY8T","xy","01M6KF8Z67443W0SHXM85JEF0B",0,"MIT","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fpdftotext-fallback\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000002","文档处理","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37],"fallback","pdftotext","pdftotext fallback","PDF","extraction","file","data","shell","text","returns","read","binary","via","pdf text extraction","2026-11-10 10:12:30",false,"---\nname: pdftotext-fallback\ndescription: Recover PDF text extraction when read_file returns binary data by using pdftotext via shell\n---\n\n# pdftotext Fallback for PDF Text Extraction\n\n## When to Use\n\nApply this pattern when:\n- `read_file` on a PDF returns binary\u002Fimage data instead of readable text\n- Python-based PDF extraction (PyMuPDF, pdfplumber, etc.) in `execute_code_sandbox` fails or returns garbled content\n- You need reliable text extraction from PDF files as a recovery strategy\n\n## Why This Works\n\nThe `pdftotext` utility (from poppler-utils) is a mature, command-line tool that handles many PDF edge cases that confuse Python libraries or the `read_file` tool. It's pre-installed on most Linux systems and provides consistent, reliable text extraction.\n\n## Steps\n\n### Step 1: Detect the Failure\n\nRecognize extraction failure when:\n- `read_file` returns binary content, image data, or garbled text\n- Error messages indicate encoding issues or unsupported formats\n- Python PDF libraries in sandbox fail with import errors or extraction failures\n\n### Step 2: Use pdftotext via run_shell\n\n**Extract to stdout** (recommended for quick extraction):\n\n```bash\npdftotext \u002Fpath\u002Fto\u002Ffile.pdf -\n```\n\nThe `-` argument outputs directly to stdout for easy capture in your tool response.\n\n**Example:**\n```bash\nrun_shell(\"pdftotext document.pdf -\")\n```\n\n### Step 3: Handle Complex PDFs\n\n**Preserve layout** (maintains original formatting):\n```bash\npdftotext -layout \u002Fpath\u002Fto\u002Ffile.pdf -\n```\n\n**Extract to a file** (for large PDFs):\n```bash\npdftotext \u002Fpath\u002Fto\u002Ffile.pdf \u002Fpath\u002Fto\u002Foutput.txt\n```\nThen read the output file with `read_file`.\n\n**Handle encoded text:**\n```bash\npdftotext -enc UTF-8 \u002Fpath\u002Fto\u002Ffile.pdf -\n```\n\n### Step 4: Verify and Continue\n\n- Check the extracted text for completeness\n- If text is still garbled, the PDF may be image-based (scanned) - consider OCR tools\n- Proceed with your task using the extracted text\n\n## Code Examples\n\n**Basic extraction:**\n```bash\n# Simple text extraction\ntext = run_shell(\"pdftotext document.pdf -\")\n```\n\n**With error handling:**\n```bash\n# Try extraction, check for success\nresult = run_shell(\"pdftotext document.pdf - && echo 'SUCCESS' || echo 'FAILED'\")\n```\n\n**Multi-page PDF with layout:**\n```bash\n# Preserve tables and formatting\ntext = run_shell(\"pdftotext -layout document.pdf -\")\n```\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| `pdftotext: command not found` | Install poppler-utils: `apt-get install poppler-utils` |\n| Garbled\u002Fspecial characters | Try `-enc UTF-8` or `-enc ASCII7` |\n| Missing formatting | Use `-layout` flag |\n| Scanned PDF (no text) | Requires OCR (e.g., tesseract), not text extraction |\n| Large PDF timeout | Extract to file instead of stdout |\n\n## Limitations\n\n- Does not work on image-only (scanned) PDFs without embedded text\n- May lose complex formatting, tables, or embedded objects\n- Requires poppler-utils to be installed (common on Linux, may need installation on other systems)\n\n## Related Tools\n\n- `pdfinfo`: Get PDF metadata (pages, size, etc.)\n- `pdftoppm`: Convert PDF pages to images\n- `tesseract`: OCR for scanned PDFs","# pdftotext Fallback for PDF Text Extraction\n\n## When to Use\n\nApply this pattern when:\n- `read_file` on a PDF returns binary\u002Fimage data instead of readable text\n- Python-based PDF extraction (PyMuPDF, pdfplumber, etc.) in `execute_code_sandbox` fails or returns garbled content\n- You need reliable text extraction from PDF files as a recovery strategy\n\n## Why This Works\n\nThe `pdftotext` utility (from poppler-utils) is a mature, command-line tool that handles many PDF edge cases that confuse Python libraries or the `read_file` tool. It's pre-installed on most Linux systems and provides consistent, reliable text extraction.\n\n## Steps\n\n### Step 1: Detect the Failure\n\nRecognize extraction failure when:\n- `read_file` returns binary content, image data, or garbled text\n- Error messages indicate encoding issues or unsupported formats\n- Python PDF libraries in sandbox fail with import errors or extraction failures\n\n### Step 2: Use pdftotext via run_shell\n\n**Extract to stdout** (recommended for quick extraction):\n\n```bash\npdftotext \u002Fpath\u002Fto\u002Ffile.pdf -\n```\n\nThe `-` argument outputs directly to stdout for easy capture in your tool response.\n\n**Example:**\n```bash\nrun_shell(\"pdftotext document.pdf -\")\n```\n\n### Step 3: Handle Complex PDFs\n\n**Preserve layout** (maintains original formatting):\n```bash\npdftotext -layout \u002Fpath\u002Fto\u002Ffile.pdf -\n```\n\n**Extract to a file** (for large PDFs):\n```bash\npdftotext \u002Fpath\u002Fto\u002Ffile.pdf \u002Fpath\u002Fto\u002Foutput.txt\n```\nThen read the output file with `read_file`.\n\n**Handle encoded text:**\n```bash\npdftotext -enc UTF-8 \u002Fpath\u002Fto\u002Ffile.pdf -\n```\n\n### Step 4: Verify and Continue\n\n- Check the extracted text for completeness\n- If text is still garbled, the PDF may be image-based (scanned) - consider OCR tools\n- Proceed with your task using the extracted text\n\n## Code Examples\n\n**Basic extraction:**\n```bash\n# Simple text extraction\ntext = run_shell(\"pdftotext document.pdf -\")\n```\n\n**With error handling:**\n```bash\n# Try extraction, check for success\nresult = run_shell(\"pdftotext document.pdf - && echo 'SUCCESS' || echo 'FAILED'\")\n```\n\n**Multi-page PDF with layout:**\n```bash\n# Preserve tables and formatting\ntext = run_shell(\"pdftotext -layout document.pdf -\")\n```\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| `pdftotext: command not found` | Install poppler-utils: `apt-get install poppler-utils` |\n| Garbled\u002Fspecial characters | Try `-enc UTF-8` or `-enc ASCII7` |\n| Missing formatting | Use `-layout` flag |\n| Scanned PDF (no text) | Requires OCR (e.g., tesseract), not text extraction |\n| Large PDF timeout | Extract to file instead of stdout |\n\n## Limitations\n\n- Does not work on image-only (scanned) PDFs without embedded text\n- May lose complex formatting, tables, or embedded objects\n- Requires poppler-utils to be installed (common on Linux, may need installation on other systems)\n\n## Related Tools\n\n- `pdfinfo`: Get PDF metadata (pages, size, etc.)\n- `pdftoppm`: Convert PDF pages to images\n- `tesseract`: OCR for scanned PDFs",{"name":5,"description":7},"main","af1b40a42167d09c30b3a63000aa14ace4c1e229","gdpval_bench\u002Fskills\u002Fpdftotext-fallback","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval","https:\u002F\u002Fgithub.com\u002Fxyliu-cs","https:\u002F\u002Fxyliu-cs.github.io","PhD Student in CS, CUHK-Shenzhen.","2026-04-06 20:32:15",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add xyliu-cs\u002FOpenSpace-GDPval --skill pdftotext-fallback",{"tool":57,"command":58},"bunx","bunx skills add xyliu-cs\u002FOpenSpace-GDPval --skill pdftotext-fallback",{"tool":60,"command":61},"pnpm","pnpm dlx skills add xyliu-cs\u002FOpenSpace-GDPval --skill pdftotext-fallback","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fpdftotext-fallback\u002FSKILL.md",true,[65],{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},".skill_id","OTHER","其他",32,"https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fpdftotext-fallback\u002F.skill_id",[72,85,93,109,132,150],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":38},"01M6KG8MF1S664SWBDENYRSCK8","zip-export-deliverable","Ensures codebase deliverables are properly exported as ZIP archives through a dedicated finalization step","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzip-export-deliverable\u002FSKILL.md",[],[79,80,81,82,83,84],"zip export deliverable","zip","export","deliverables","codebase","as",{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":38},"01M6KG8GAZWHHEK7VNJDW0ME21","zip-deliverable-finalization","Ensure codebase deliverables are properly packaged as ZIP exports in a dedicated final step","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzip-deliverable-finalization\u002FSKILL.md",[],[92,80,82,83,84],"zip deliverable finalization",{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":38},"01M6KG8CMQQ1PYMNTSRZ9VS1MD","zero-iteration-failure-analysis","Identify and handle agent failures with 0 iterations as pre-execution system issues","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzero-iteration-failure-analysis\u002FSKILL.md",[],[100,101,102,103,104,105,106,107,84,108],"failure analysis","ZeRO","analysis","iteration","zero iteration failure analysis","with","issues","execution","system",{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":120,"publishedAt":38},"01M6KG86W3PA07FT9W58YHHERM","write-file-fallback-report","Generate professional documents using write_file when primary data sources fail, leveraging embedded domain knowledge instead of external retrieval","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report\u002FSKILL.md",[115],{"categoryNo":116,"categoryName":117,"taxonomyType":118,"taxonomyTypeDesc":119},"01JBSEEDCAT000000000000034","行政与办公人员","PROFESSION","适用职业",[24,121,29,122,123,124,125,126,127,128,129,130,30,131],"write","report","write file fallback report","domain","professional","sources","retrieval","generate","embedded","documents","knowledge",{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":141,"publishedAt":38},"01M6KG82GAEY3GG77CMGCK1C2T","fallback-doc-with-delegation","Generate professional documents after tool failures using shell_agent for complex formats or write_file for simple text\u002Fmarkdown","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report-enhanced\u002FSKILL.md",[138],{"categoryNo":139,"categoryName":140,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[142,105,24,143,144,31,130,128,29,145,146,32,121,147,125,148,149],"fallback doc with delegation","doc","delegation","markdown","tool","simple","formats","for",{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":157,"publishedAt":38},"01M6KG7WT7GX5NYCGEFHW22NV7","context-anchored-fallback-report","Generate documents with write_file when retrieval tools fail, with explicit guardrails against task context drift","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report-enhanced-4bc5c2\u002FSKILL.md",[156],{"categoryNo":116,"categoryName":117,"taxonomyType":118,"taxonomyTypeDesc":119},[24,122,158,159,128,29,160,161,121,162,163,127,105,164,130],"context","context anchored fallback report","Guardrails","Tools","task","drift","context drift"]