| name | document-markdown-converter |
| description | Hướng dẫn tiền xử lý (pre-processing) tài liệu nhị phân (PDF, DOCX, XLSX, PPTX, HTML, v.v.) bằng công cụ Microsoft MarkItDown thành định dạng Markdown (MD). Kỹ năng này giúp Agent bóc tách cấu trúc dữ liệu, bảng biểu và text một cách chuẩn xác mà không cần đọc trực tiếp file nhị phân, qua đó tiết kiệm token tối đa. Sử dụng kỹ năng này khi người dùng yêu cầu đọc file tài liệu thiết kế (FS) hoặc bất cứ khi nào thấy file PDF/Word được cung cấp làm đầu vào. Triggers: `markitdown`, `convert fs`, `parse document`, `tiền xử lý tài liệu`, `pdf`, `docx`. |
Document Markdown Converter (MarkItDown Integration)
Guide for pre-processing binary Functional Specification (FS) documents into Markdown format for token-efficient analysis.
Core Objective
Never attempt to read raw binary files (.pdf, .docx, .xlsx) directly. Always use markitdown CLI to convert them to structured Markdown format first, and then analyze the resulting Markdown file.
Workflow
1. Environment Verification
Check if the virtual environment binary exists using a relative path from the workspace root:
./.venv_markitdown/bin/markitdown --version
If the command fails (command not found), create the venv locally and install it (requires Python >= 3.10):
python3 -m venv .venv_markitdown && ./.venv_markitdown/bin/pip install 'markitdown[all]'
2. Document Conversion
Locate the input file (usually inside artifacts/fs_docs/).
Execute the conversion command and output to the artifacts/scratchpads/ directory:
./.venv_markitdown/bin/markitdown "artifacts/fs_docs/[Your_File_Name.ext]" -o "artifacts/scratchpads/fs_markdown.md"
3. Handoff to Analysis
Once fs_markdown.md is generated successfully, stop reading the original document. Direct your view_file tool to read artifacts/scratchpads/fs_markdown.md instead.
The resulting markdown will contain preserved headings, lists, and tables which you can easily parse for Data Model and UI elements extraction.
Optional: LLM OCR for Images
If the document is known to contain complex images (flowcharts, UI mockups) embedded within it, you can utilize the markitdown-ocr plugin if configured, or fallback to the fs-vision-extractor skill to handle images separately. For standard text and tables, the base markitdown command is perfectly sufficient.
