Catalog
affaan-m/visa-doc-translate

affaan-m

visa-doc-translate

Translate visa application documents (images) to English and create a bilingual PDF with original and translation. Use when visa application document images must be translated to English as a bilingual PDF.

NewUpdated Sep 9, 2026

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.

Files2
2 files · 2.8 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

78

Quality

68

Clarity

76

Completeness

65

Summary

A visa document translation skill that converts document images to bilingual PDFs by performing OCR extraction, professional translation to English, and PDF generation. The skill automates the entire workflow from image input through document formatting without user confirmation at intermediate steps.

Detected Capabilities

file readimage conversion (HEIC to PNG)EXIF metadata extractionOCR text extraction (multiple methods)text translationPDF generationlocal file write

Trigger Keywords

Phrases that agents use to match this skill to user intent.

translate visa documentsvisa application pdfbilingual document translationocr english translationvisa certificate conversion

Risk Signals

INFO

Automatic file write without user confirmation - generates PDF in same directory as input

Instructions section, step 6
INFO

Multiple OCR library installations attempted without validation

Technical Implementation section
INFO

Automatic image rotation based on EXIF data without preview

Instructions section, step 2
WARNING

Document type identification is claimed but methodology not specified

Instructions section, step 3

Use Cases

  • Translate bank deposit certificates for visa applications
  • Convert employment certificates to English for immigration
  • Process retirement certificates as bilingual PDFs
  • Generate official English translations of property documents
  • Translate ID cards and passports for visa submissions
  • Create professional bilingual PDFs for multiple visa programs (US, Canada, Australia, UK)

Quality Notes

  • Skill clearly specifies the automation-first approach upfront (no confirmation steps), which is appropriate for the use case
  • Well-structured steps that follow a logical workflow from input to output
  • Supported document types are clearly enumerated with both English and Chinese labels
  • README and SKILL.md content is consistent and comprehensive
  • Technical implementation section provides specific library names and installation commands
  • OCR method fallback strategy is documented but implementation details are vague
  • Translation guidelines (handling Chinese names with pinyin, proper names in original language) are professional and specific
  • Edge case handling is missing - e.g., no guidance for OCR failure, multi-page documents, or very large images
  • Error handling and validation steps are not documented - agent has no clear path if OCR fails or image is corrupted
  • Output validation is not specified - no guidance on verifying PDF generation success
Model: claude-haiku-4-5-20251001Analyzed: Sep 9, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Version History

  1. v2.0

    Contract changed: description

    ✦ AIClarifies activation context in skill description for agent matching.

    triggering2026-09-09

    LATEST
  2. v1.1

    Content updated

    ✦ AIREADME and supporting documentation updated; LICENSE file added.

    2026-04-20

    View This Version
  3. v1.0

    Seeded from github.com/affaan-m/everything-claude-code

    2026-03-16

    View This VersionInitial version

Use affaan-m/visa-doc-translate in your dev environment

Command Palette

Search for a command to run...