visa-doc-translate
affaan-m/ecc
Translate visa documents to English and generate bilingual PDFs automatically
What is visa-doc-translate?
Converts visa application documents (images) to English using OCR and creates a two-page bilingual PDF with the original image and professional English translation. Use this when you need certified translations of bank certificates, employment letters, ID documents, or other official papers for visa applications.
- Automatically converts HEIC images to PNG and corrects orientation using EXIF data
- Extracts text from documents using macOS Vision, EasyOCR, or Tesseract OCR
- Translates extracted text to professional English while preserving document structure and proper names
- Generates a two-page PDF with original image on page 1 and formatted English translation on page 2
- Supports bank deposits, income certificates, employment letters, retirement certificates, property documents, and ID cards
- Adds certification note to translated pages for official use
How to install visa-doc-translate
npx skills add null --skill visa-doc-translate- Python with PIL and reportlab libraries installed
- For macOS: pyobjc-framework-Vision and pyobjc-framework-Quartz
- For cross-platform: EasyOCR (pip install easyocr)
- Optional: Tesseract OCR for fallback (brew install tesseract)
How to use visa-doc-translate
- 1.Install required Python libraries: pip install pillow reportlab easyocr
- 2.Provide the image file path (supports JPG, PNG, HEIC)
- 3.The skill automatically converts format, corrects rotation, and extracts text
- 4.Review the generated PDF with original and translation
- 5.Use the output PDF for your visa application
Use cases
- Translating Chinese bank deposit certificates for Australian visa applications
- Converting employment verification letters to English for US work visa submissions
- Processing retirement certificates for Canadian immigration applications
- Translating property or business license documents for UK visa requirements
- Batch processing multiple official documents for visa application packages
- Visa applicants needing document translations
- Immigration consultants preparing application packages
- International students translating financial documents
- Professionals relocating internationally
visa-doc-translate FAQ
JPG, PNG, and HEIC formats are supported. HEIC files are automatically converted to PNG.
Yes, it uses EasyOCR for cross-platform support. macOS Vision framework is preferred on macOS but EasyOCR works on all platforms.
OCR accuracy depends on document quality and language. Professional terminology is used for visa documents, but you should review the translation before submission.
Yes, it supports any language that EasyOCR or Tesseract can recognize, though it's optimized for visa documents commonly requiring English translation.
Page 1 shows the original rotated document image centered on an A4 page. Page 2 contains the professional English translation with a certification note at the bottom.
Full instructions (SKILL.md)
Source of truth, from affaan-m/ecc.
name: visa-doc-translate description: Translate visa application documents (images) to English and create a bilingual PDF with original and translation
You are helping translate visa application documents for visa applications.
Instructions
When the user provides an image file path, AUTOMATICALLY execute the following steps WITHOUT asking for confirmation:
-
Image Conversion: If the file is HEIC, convert it to PNG using
sips -s format png <input> --out <output> -
Image Rotation:
- Check EXIF orientation data
- Automatically rotate the image based on EXIF data
- If EXIF orientation is 6, rotate 90 degrees counterclockwise
- Apply additional rotation as needed (test 180 degrees if document appears upside down)
-
OCR Text Extraction:
- Try multiple OCR methods automatically:
- macOS Vision framework (preferred for macOS)
- EasyOCR (cross-platform, no tesseract required)
- Tesseract OCR (if available)
- Extract all text information from the document
- Identify document type (deposit certificate, employment certificate, retirement certificate, etc.)
- Try multiple OCR methods automatically:
-
Translation:
- Translate all text content to English professionally
- Maintain the original document structure and format
- Use professional terminology appropriate for visa applications
- Keep proper names in original language with English in parentheses
- For Chinese names, use pinyin format (e.g., WU Zhengye)
- Preserve all numbers, dates, and amounts accurately
-
PDF Generation:
- Create a Python script using PIL and reportlab libraries
- Page 1: Display the rotated original image, centered and scaled to fit A4 page
- Page 2: Display the English translation with proper formatting:
- Title centered and bold
- Content left-aligned with appropriate spacing
- Professional layout suitable for official documents
- Add a note at the bottom: "This is a certified English translation of the original document"
- Execute the script to generate the PDF
-
Output: Create a PDF file named
<original_filename>_Translated.pdfin the same directory
Supported Documents
- Bank deposit certificates (存款证明)
- Income certificates (收入证明)
- Employment certificates (在职证明)
- Retirement certificates (退休证明)
- Property certificates (房产证明)
- Business licenses (营业执照)
- ID cards and passports
- Other official documents
Technical Implementation
OCR Methods (tried in order)
-
macOS Vision Framework (macOS only):
import Vision from Foundation import NSURL -
EasyOCR (cross-platform):
pip install easyocr -
Tesseract OCR (if available):
brew install tesseract tesseract-lang pip install pytesseract
Required Python Libraries
pip install pillow reportlab
For macOS Vision framework:
pip install pyobjc-framework-Vision pyobjc-framework-Quartz
Important Guidelines
- DO NOT ask for user confirmation at each step
- Automatically determine the best rotation angle
- Try multiple OCR methods if one fails
- Ensure all numbers, dates, and amounts are accurately translated
- Use clean, professional formatting
- Complete the entire process and report the final PDF location
Example Usage
/visa-doc-translate RetirementCertificate.PNG
/visa-doc-translate BankStatement.HEIC
/visa-doc-translate EmploymentLetter.jpg
Output Example
The skill will:
- Extract text using available OCR method
- Translate to professional English
- Generate
<filename>_Translated.pdfwith:- Page 1: Original document image
- Page 2: Professional English translation
Perfect for visa applications to Australia, USA, Canada, UK, and other countries requiring translated documents.
Related skills
More from affaan-m/ecc and the wider catalog.
vite-patterns
Vite build tool patterns for config, plugins, HMR, and optimization.
vue-patterns
Agent skill from affaan-m/ecc.
windows-desktop-e2e
E2E testing for Windows native desktop apps (WPF, WinForms, Win32/MFC, Qt) via pywinauto and UI Automation.
workspace-surface-audit
Audit your workspace setup and recommend the highest-value ECC-native skills, hooks, and agents to enable next.
x-api
Post tweets, read timelines, search, and track analytics on X/Twitter via OAuth.

agent-harness-construction
Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates.