visa-doc-translate
Helps your agent translate visa document images into English. Useful for immigration processes needing official translations.
What it does
This tool transforms visa documents into English. It reads text from images (like bank or employment statements), translates it into professional English, and creates a bilingual PDF with the original and the translation.
When to use it
- ✓Need to translate a document for a visa application.
- ✓Have an official certificate in image format that requires certified translation.
- ✓Want a PDF with the original document and its English translation side-by-side.
Example of what to ask your AI
“Translate this employment certificate into English.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The AI first adjusts the image (if needed) and uses text recognition technology (OCR) to read the content. Then, it translates the text into formal English, maintaining accuracy of numbers and dates, and generates a PDF with the original document and the translation.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add affaan-m/ECC --skill visa-doc-translateOr download just the file:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/visa-doc-translate/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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 NSURLEasyOCR (cross-platform):
pip install easyocrTesseract 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.
FAQ
What types of documents are supported?
It supports bank deposit certificates, income certificates, employment certificates, retirement certificates, property certificates, business licenses, ID cards, passports, and other official documents.
Is the translation official?
The tool creates a translation in a certified style, suitable for visa applications, but it does not replace an official sworn translation done by a certified public translator.
What image formats are accepted?
It accepts HEIC, PNG, and JPG files.
Details
Original description by the author
Translate visa document images (bank deposit, employment, income, and retirement certificates; HEIC, PNG, or JPG) into English via OCR and produce a bilingual PDF pairing the original image with a formatted certified-style translation. Use when a visa application needs a document translated to English, an official certificate OCR'd and translated, or a bilingual translation PDF for immigration pap
repo: affaan-m/ECC
Popularity
- GitHub stars
- 280k
- Ranking position
- #309
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
accessibility
Helps your agent create interfaces that everyone can use. Ensures websites and apps work well for people with disabilities, like those who are blind or have reduced mobility.
affaan-m/ECC
agent-architecture-audit
Makes your agent check if everything is working correctly. It finds and fixes problems in AI systems, ensuring they perform as expected.
affaan-m/ECC
agent-eval
Helps your agent compare different AI coding tools. It measures which one is faster, cheaper, and more reliable for specific tasks.
affaan-m/ECC
agent-harness-construction
Makes your agent better understand how to perform tasks. It optimizes the tools and instructions the agent uses to increase its chances of success.
affaan-m/ECC
Similar skills
doc-coauthoring
Helps your agent guide you in writing important documents. It's useful when you need to create documentation, proposals, or specifications.
anthropics/skills
docx
Helps your agent create, read, edit, and organize Word documents. It's useful for generating professional reports with complex formatting.
anthropics/skills
internal-comms
Lets your agent write internal communications in the company's preferred format. Useful for reports, newsletters, and updates.
anthropics/skills