
Visa Doc Translate
- 1.4k installs
- 238k repo stars
- Updated August 5, 2026
- affaan-m/ecc
This is a copy of visa-doc-translate by affaan-m - installs and ranking accrue to the original listing.
visa-doc-translate is an agent skill that converts foreign-language visa application images into professional bilingual English PDFs for developers and applicants preparing embassy submissions.
About
visa-doc-translate is an ECC agent skill that automates visa document localization from image inputs to submission-ready bilingual PDFs. When given an image path, the skill converts HEIC files to PNG with macOS sips, reads EXIF orientation and applies automatic rotation, then produces side-by-side original and English translation pages in a single PDF. The workflow runs without confirmation prompts so agents can batch embassy paperwork quickly. Developers reach for visa-doc-translate when supporting users who photograph foreign-language bank letters, employment certificates, or government forms and need consistent English translations packaged for consular review.
- Automatically detects and processes HEIC, PNG, and JPEG visa document images
- Performs EXIF-based auto-rotation for correctly oriented output
- Combines multiple OCR engines (macOS Vision, EasyOCR, Tesseract) for highest accuracy
- Executes professional translation while preserving document structure and legal terminology
- Outputs ready-to-submit bilingual PDF with original scan and English translation side-by-side
Visa Doc Translate by the numbers
- 1,356 all-time installs (skills.sh)
- +84 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/affaan-m/ecc --skill visa-doc-translateAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.4k |
|---|---|
| repo stars | ★ 238k |
| Last updated | August 5, 2026 |
| Repository | affaan-m/ecc ↗ |
How do you translate visa document images to bilingual PDFs?
Automatically convert foreign-language visa application images into professional bilingual English PDFs ready for submission.
Who is it for?
Developers automating visa paperwork pipelines where applicants upload phone photos of foreign-language certificates and need embassy-ready bilingual PDFs.
Skip if: Developers building general OCR APIs, programmatic visa eligibility logic, or non-document translation workflows without image inputs.
When should I use this skill?
User provides a visa application image path and needs automatic HEIC conversion, EXIF rotation, translation, and bilingual PDF output.
What you get
Bilingual PDF with rotated source images, English translations, and original pages preserved for embassy submission.
- bilingual PDF
- rotated PNG intermediates
By the numbers
- Applies automatic EXIF-based rotation including orientation value 6 (90° counterclockwise)
Files
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:
1. Image Conversion: If the file is HEIC, convert it to PNG using sips -s format png <input> --out <output>
2. 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)
3. 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.)
4. 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
5. 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
6. Output: Create a PDF file named <original_filename>_Translated.pdf in 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)
1. macOS Vision Framework (macOS only):
import Vision
from Foundation import NSURL2. EasyOCR (cross-platform):
pip install easyocr3. Tesseract OCR (if available):
brew install tesseract tesseract-lang
pip install pytesseractRequired Python Libraries
pip install pillow reportlabFor macOS Vision framework:
pip install pyobjc-framework-Vision pyobjc-framework-QuartzImportant 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.jpgOutput Example
The skill will: 1. Extract text using available OCR method 2. Translate to professional English 3. Generate <filename>_Translated.pdf with:
- 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.
Visa Document Translator
Automatically translate visa application documents from images to professional English PDFs.
Features
- Automatic OCR: Tries multiple OCR methods (macOS Vision, EasyOCR, Tesseract)
- Bilingual PDF: Original image + professional English translation
- Multi-language: Supports Chinese, and other languages
- Professional Format: Suitable for official visa applications
- Fully Automated: No manual intervention required
Supported Documents
- Bank deposit certificates (存款证明)
- Employment certificates (在职证明)
- Retirement certificates (退休证明)
- Income certificates (收入证明)
- Property certificates (房产证明)
- Business licenses (营业执照)
- ID cards and passports
Usage
/visa-doc-translate <image-file>Examples
/visa-doc-translate RetirementCertificate.PNG
/visa-doc-translate BankStatement.HEIC
/visa-doc-translate EmploymentLetter.jpgOutput
Creates <filename>_Translated.pdf with:
- Page 1: Original document image (centered, A4 size)
- Page 2: Professional English translation
Requirements
Python Libraries
pip install pillow reportlabOCR (one of the following)
macOS (recommended):
pip install pyobjc-framework-Vision pyobjc-framework-QuartzCross-platform:
pip install easyocrTesseract:
brew install tesseract tesseract-lang
pip install pytesseractHow It Works
1. Converts HEIC to PNG if needed 2. Checks and applies EXIF rotation 3. Extracts text using available OCR method 4. Translates to professional English 5. Generates bilingual PDF
Perfect For
- Australia visa applications
- USA visa applications
- Canada visa applications
- UK visa applications
- EU visa applications
License
MIT
Related skills
How it compares
Choose visa-doc-translate over generic translation skills when the input is visa scan images and the deliverable must be a bilingual PDF with corrected orientation.
FAQ
What file formats does visa-doc-translate accept?
visa-doc-translate accepts image file paths, including HEIC from iPhone cameras. HEIC inputs are converted to PNG with macOS sips before EXIF rotation and bilingual PDF assembly.
Does visa-doc-translate require manual confirmation steps?
visa-doc-translate runs automatically without asking for confirmation. The skill converts formats, rotates by EXIF, translates content, and outputs a bilingual PDF in one pass.