Skip to main content
Agent skill

Visa Doc Translate

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 paperwork.

Get started

Get the complete skill folder, including its scripts and reference files.

·

When to use this skill

Use Visa Doc Translate when an AI agent needs a reusable SKILL.md workflow for this job: 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 paperwork.

When not to use it

Skip Visa Doc Translate when the task is outside the writing category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.

How to install

Where will you use it?

Install scope
Claude Code folder setup
mkdir -p ~/.claude/skills/visa-doc-translate
# Save SKILL.md to ~/.claude/skills/visa-doc-translate/SKILL.md
  1. Claude Code personal install: place the skill and its bundled files at ~/.claude/skills/visa-doc-translate/SKILL.md. For a shared project, commit the folder at .claude/skills/visa-doc-translate/ instead.
  2. Current Claude Code detects SKILL.md changes in watched directories during the session. If you just created a top-level skills directory, run /reload-skills. Check that the skill is listed before testing its trigger.
  3. For Claude chat or Cowork in the Desktop app, manage uploaded skills in Customize > Skills; copying files into a local Claude Code folder is not a Desktop install. Other agents may use different install locations.

Full install guide for Claude, Cursor, and Codex →

Try a starter prompt

After installing the skill, paste this starter prompt into your agent to verify it triggers on a small task.

Starter prompt
Use the Visa Doc Translate skill for this task: Use Visa Doc Translate when this documented workflow matches the task. Confirm any required inputs or files before making changes.

What supports this recommendation?

76/100 provisional content score. This measures documentation, practical detail and source signals. It is not a measured task success rate or a security certification.

Documentation
85/100
Practical detail
76/100
Source evidence
63/100
Source signals
72/100
Model compatibility evidence
  • claudeuntested

    No model-specific signal or recorded compatibility test was found.

  • chatgptuntested

    No model-specific signal or recorded compatibility test was found.

  • geminiuntested

    No model-specific signal or recorded compatibility test was found.

  • copilotuntested

    No model-specific signal or recorded compatibility test was found.

  • llamauntested

    No model-specific signal or recorded compatibility test was found.

  • perplexityuntested

    No model-specific signal or recorded compatibility test was found.

  • mistraluntested

    No model-specific signal or recorded compatibility test was found.

  • grokuntested

    No model-specific signal or recorded compatibility test was found.

Inferred compatibility is based on content signals. Check the app, its available tools and setup requirements before running a skill.

What this skill does

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): ```python import Vision from Foundation import NSURL ```

2. **EasyOCR** (cross-platform): ```bash pip install easyocr ```

3. **Tesseract OCR** (if available): ```bash brew install tesseract tesseract-lang pip install pytesseract ```

### Required Python Libraries

```bash pip install pillow reportlab ```

For macOS Vision framework: ```bash 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

```bash /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.

Intended uses

  • Use Visa Doc Translate when this documented workflow matches the task.

Implementation notes

  • 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

Try it, then tell us how it went

A copied prompt does not tell us whether the task worked. Report your result after checking the output. We collect your tool and outcome, never your files or prompt.