file-analyst

name	file-analyst
description	Analyze local files via scripts/file_analyst.py. Actions — summarize/contract/datasheet/extract/stats for PDF/DOCX/CSV/XLSX/TXT/JSON/MD; ocr/ocr_translate for images (jpg/png/webp/bmp/tiff) AND scanned PDFs (Tesseract 5.x); pdf_to_md for PDF→Markdown conversion (MarkItDown). Examples — 'summarize --path report.pdf', 'contract --path lease.pdf', 'datasheet --path tpa3255.pdf', 'ocr --path scan.jpg', 'ocr_translate --path image.png --to he', 'pdf_to_md --path report.pdf'. Trigger when asked to read, summarize, extract data from files, analyze a lease/rental contract (use 'contract'), analyze a technical datasheet / IC spec sheet (use 'datasheet'), read text from an image (use 'ocr'), or translate text inside an image (use 'ocr_translate'). CRITICAL: NEVER pass a file path that was not explicitly confirmed by a prior tool output (look for 'saved to' in tool output). Invented file paths will fail. Only use paths that were created by a tool or provided by the user.
metadata	{"clawdbot":{"emoji":"📄","commands":["summarize","extract","convert","stats","check","extract_tables","chart","contract","datasheet","analyze","ocr","ocr_translate","ocr_pdf","redact","batch","pdf_to_md"],"arg_template":"scripts/file_analyst.py {command} {args}","timeout":90,"requires":{"bins":["python"],"python_libs":["PyPDF2","pdfplumber","pdfminer.six","python-docx","openpyxl","pandas","pytesseract","Pillow","deep-translator","pymupdf"]},"install":[{"id":"pip-files","kind":"pip","packages":["PyPDF2","pdfplumber","pdfminer.six","python-docx","openpyxl","pandas","pytesseract","Pillow","deep-translator","pymupdf"],"label":"Install file analysis dependencies (baseline)"},{"id":"pip-ml-extras","kind":"pip","optional":true,"packages":["markitdown"],"label":"Optional ML extras (MarkItDown for PDF→Markdown)"}],"commands_schema":{"summarize":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"extract":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"convert":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"stats":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"check":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"extract_tables":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"chart":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"contract":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"datasheet":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"analyze":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"ocr":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"ocr_translate":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"ocr_pdf":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"redact":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"pdf_to_md":{"properties":{"path":{"type":"string","description":"Path to the file to analyze"},"output":{"type":"string","description":"Output file path (optional)"}},"required":["path"]},"batch":{"properties":{"dir":{"type":"string","description":"Directory to batch process"},"pattern":{"type":"string","default":"*"},"batch_action":{"type":"string","default":"summarize"}},"required":["dir"]}}}}