visa-doc-translate

SkillDocs & knowledge

visa-doc-translate is a skill that translates visa document images into English. It reads bank deposit, employment, income, and retirement certificates from HEIC, PNG, or JPG files, extracts the text with OCR, and produces a bilingual PDF that pairs the original image with a formatted certified-style translation.

Use visa-doc-translate in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add visa-doc-translate and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the visa-doc-translate skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have an image of a visa document in HEIC, PNG, or JPG format.

visa-doc-translateStart free

What your AI can do with it

  • Reads HEIC, PNG, and JPG images of visa documents
  • Extracts text using macOS Vision, EasyOCR, or Tesseract
  • Translates bank deposit, employment, income, and retirement certificates
  • Preserves names, numbers, and dates in the translation
  • Creates a two-page PDF with the original image and translation

Getting started

  1. Have an image of a visa document in HEIC, PNG, or JPG format.
  2. Make sure an OCR method is available: macOS Vision, EasyOCR, or Tesseract.
  3. Run the skill on the image file.
  4. Collect the bilingual PDF that shows the original image and the English translation.

What this skill tells your AI

The instructions your AI receives, as published by affaan-m/ecc in skills/visa-doc-translate/SKILL.md and read by ahel’s review.

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 NSURL
    
  2. EasyOCR (cross-platform):

    pip install easyocr
    
  3. 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:

  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.

Signals

GitHub stars
270k
Forks
40k
Last commit
Sep 2026

ahel review

  • K1binfo
    installs-packages
  • K1binfo
    installs-packages (in README.md)

Automated review, not a security audit. Ruleset v1+k2.

Questions

What file types does it support?
It supports HEIC, PNG, and JPG images of visa documents.
What OCR methods does it use?
It uses whichever OCR method is available: macOS Vision, EasyOCR, or Tesseract.
What documents can it translate?
It translates bank deposit, employment, income, and retirement certificates.
What does the output look like?
It produces a two-page PDF with the original image on one page and a formatted certified-style English translation on the other.
Does it preserve names, numbers, and dates?
Yes, the translation preserves names, numbers, and dates from the original document.
Advanced
Item type
skill
Key
visa-doc-translate
Source
github.com/affaan-m/ecc