Agent skill

Visa Doc Translate

by affaan-m in affaan-m/ECC

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…

MITAuto-check passedWriting & Content

Install Visa Doc Translate

skills CLI
$ npx skills add affaan-m/ECC --skill visa-doc-translate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install affaan-m/ECC visa-doc-translate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/visa-doc-translate .claude/skills/visa-doc-translate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
visa-doc-translate
GitHub stars
277k
Used in
4 other repos
Token cost
~1k tokens
SKILL.md length
411 words
Files
2
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 6 steps: Image Conversion: If the file is HEIC,… → Image Rotation → OCR Text Extraction → …
  • A visa application needs a document translated to English
  • SKILL.md covers Instructions, Supported Documents, Technical Implementation and Important Guidelines, plus 2 more sections
  • Calls pip and brew

What it does

Visa Doc Translate is an agent skill from affaan-m/ECC. 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.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Writing & Content, covering Translation and PDF. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • A visa application needs a document translated to English
  • An official certificate OCRd and translated
  • A bilingual translation PDF for immigration paperwork

Example prompts

  • “/visa-doc-translate”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Image Conversion: If the file is HEIC, convert it to PNG using sips -s format png --out
  2. Image Rotation
  3. OCR Text Extraction
  4. Translation
  5. PDF Generation
  6. Output: Create a PDF file named _Translated.pdf in the same directory

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Visa Doc Translate loads about 1k tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 411 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 411 words, ~1,027 tokens.

Download SKILL.mdSave it as .claude/skills/visa-doc-translate/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
visa-doc-translate
description
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.

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

Show full SKILL.md (170 more words)Show less

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.

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/visa-doc-translate of affaan-m/ECC.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 2d515e4

Used in 4 other repositories

We found 9 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 4 other GitHub owners. This page covers the copy in affaan-m/ECC, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Visa Doc Translate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Visa Doc Translate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Visa Doc Translate this skillaffaan-m/ECC277k4 repos~1kAutomated safety check: PassMIT
Cuimao TranslatorCuimao777/cuimao-translator487—~3.2kAutomated safety check: PassNone
PDF Translatelxsssssss/pdf-translate102—~1.6kAutomated safety check: PassMIT
Translate Bookdeusyu/translate-book2.1k—~5.5kAutomated safety check: NotesMIT
PDF Translatebreslee1707/VI-Translate676—~2kAutomated safety check: PassAGPL-3.0-only
Paper PDF TranslatorYuan1z0825/nature-skills47k—~1kAutomated safety check: PassApache-2.0

Similar skills

  • Cuimao Translator

    Cuimao777/cuimao-translator

    Translate English PDF books into natural Chinese with three quality modes.

    487 GitHub stars~3.2k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • PDF Translate

    lxsssssss/pdf-translate

    A skill your agent uses when translating PDF documents between languages while strictly preserving original layout, formatting, typography, tables, and signatures.

    102 GitHub stars~1.6k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Translate Book

    deusyu/translate-book

    Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents.

    2.1k GitHub stars~5.5k tokensUpdated 17 days ago
    Documents & OfficeAuto-check: notes
  • PDF Translate

    breslee1707/VI-Translate

    Translate local PDFs, including safe prose on image-only scans, into Vietnamese or another supported Latin-script language while preserving layout, formulas, tables, and figures.

    676 GitHub stars~2k tokensUpdated 10 days ago
    Documents & OfficeAuto-check passed
  • Paper PDF Translator

    Yuan1z0825/nature-skills

    Translates an English paper PDF, all pages or a chosen range, into a Simplified Chinese image-based PDF that keeps the original layout, figures and formulas.

    47k GitHub stars~1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Print Compatible Book Layout

    SaberOnGo/public-domain-books-translation

    A skill your agent uses when designing, translating, reviewing, or fixing LifeBook book/page layout, including print-compatible EPUB typography, Chinese title hierarchy, body rhythm, paragraph…

    267 GitHub stars~4.1k tokensUpdated 6 days ago
    Documents & OfficeAuto-check passed

More from affaan-m/ECC

All 682 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Questions about Visa Doc Translate

What does Visa Doc Translate do?

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…. Visa Doc Translate is an agent skill from affaan-m/ECC. 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.

When should I use Visa Doc Translate?

Visa Doc Translate fits situations like: A visa application needs a document translated to English; an official certificate OCRd and translated; A bilingual translation PDF for immigration paperwork.

How do I install Visa Doc Translate in Claude Code?

Run `npx skills add affaan-m/ECC --skill visa-doc-translate -a claude-code`. Or copy the skill folder (skills/visa-doc-translate in affaan-m/ECC) into .claude/skills/visa-doc-translate in your project. Claude Code loads it when a task matches its description.

How do I install Visa Doc Translate in Codex?

Run `npx skills add affaan-m/ECC --skill visa-doc-translate -a codex`. Or copy the skill folder (skills/visa-doc-translate in affaan-m/ECC) into .agents/skills/visa-doc-translate in your project. Codex loads it when a task matches its description.

Can I use Visa Doc Translate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill visa-doc-translate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/visa-doc-translate, .gemini/skills/visa-doc-translate, .github/skills/visa-doc-translate and .opencode/skills/visa-doc-translate in your project.

What does Visa Doc Translate need to run?

Going by SKILL.md and its folder, Visa Doc Translate needs the command-line tools its instructions call (pip and brew). Our summary lists: Python 3.

Does Visa Doc Translate access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Visa Doc Translate safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Visa Doc Translate use?

Visa Doc Translate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Visa Doc Translate use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Visa Doc Translate?

Skills that share tags, products or a category with Visa Doc Translate: Cuimao Translator (Cuimao777/cuimao-translator, 487 stars), PDF Translate (lxsssssss/pdf-translate, 102 stars), Translate Book (deusyu/translate-book, 2.1k stars) and PDF Translate (breslee1707/VI-Translate, 676 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Visa Doc Translate?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.