visa-doc-translate

visa-doc-translate スキルの概要

visa-doc-translate は、ビザ申請書類の画像を、原本ページと英訳を並べたバイリンガル PDF に変換するためのワークフロースキルです。銀行残高証明、在職証明書、退職証明、収入証明、不動産関連書類、営業許可証、身分証など、補足書類をすばやく構造を保ったまま翻訳したい人に向いています。

visa-doc-translate は何のためのスキルか

visa-doc-translate skill が想定しているのは、実務で一つのことを確実にやることです。つまり、画像ファイルから文字を安定して抽出し、丁寧に翻訳し、レイアウトや日付、氏名、金額がビザ審査で使える程度に保たれるように整えることです。これは一般的な翻訳プロンプトではなく、レイアウトや表記、数値の正確さが重要な文書処理向けです。

どんな人にインストール向きか

スキャンや撮影したビザ書類を頻繁に扱い、そのたびに場当たり的に対応するのではなく、再現性のある手順にしたいなら visa-doc-translate を入れる価値があります。特に、バイリンガル出力が必要な場合、OCR のフォールバック手段が欲しい場合、回転補正や HEIC 変換を自動で任せたい場合に役立ちます。

何が違うのか

単なる「この画像を翻訳して」プロンプトと比べると、visa-doc-translate には文書向けの処理が最初から組み込まれています。画像変換、EXIF の回転補正、OCR 手法のフォールバック、PDF 出力形式です。ビザ書類では、数字が一つ抜けたり、氏名を読み違えたりするだけで結果が使えなくなるため、この違いは重要です。

visa-doc-translate スキルの使い方

visa-doc-translate をインストールする

リポジトリのコンテキストにあるインストールコマンドを使います。

npx skills add affaan-m/everything-claude-code --skill visa-doc-translate

インストール後は、スキルが環境で利用可能になっていることと、文書画像のパスを指定して呼び出せることを確認してください。Claude Code 以外のワークフローを使っている場合は、同じコマンド構文がどこでも動くと決めつけず、スキルのロジックを自分のエージェントやスクリプトランナーに合わせて組み込む必要があります。

スキルに正しい入力を渡す

visa-doc-translate usage の基本はシンプルです。曖昧な作業指示ではなく、ローカルの画像ファイルを渡します。良い入力例は次のとおりです。

• /visa-doc-translate ./documents/BankStatement.HEIC
• /visa-doc-translate ./scan/employment-certificate.jpg

出力の精度を上げたいなら、文書の種類や特別な注意点もプロンプトに入れてください。たとえば「会社名は原語のまま残す」「金額と日付は厳密に保持する」といった指定です。そうすることで、スキルが用語選択と出力形式をより安全に判断しやすくなります。

最初に確認するファイル

最速で使い始めるなら、まず SKILL.md を見て、そのあと README.md を確認してください。これら 2 つのファイルに、想定フロー、対応文書タイプ、出力の形、必要なライブラリがまとまっています。このリポジトリには追加の補助フォルダがないため、visa-doc-translate guide の実装意図はほぼこの 2 ファイルに集約されています。

結果に影響するワークフロー上のコツ

できるだけ傾きのないきれいなスキャンを使うのが理想ですが、できない場合でも、スキル内蔵の回転補正と OCR フォールバックに任せられます。HEIC ファイルは、元の形式がそれならそのままで構いません。変換はスキル側で処理します。翻訳品質を上げたいなら、端が切れている画像、コントラストが低い画像、スクリーンショットのスクリーンショットは避けてください。翻訳前の OCR 精度が落ちてしまいます。

visa-doc-translate スキル FAQ

visa-doc-translate はビザ書類専用ですか？

はい。スキルの中心はビザ関連の補足書類です。似た官公文書に応用することはできますが、visa-doc-translate skill が最も説得力を持つのは、申請審査用にレイアウトを忠実に保ちながら英訳も必要な文書です。

事前に OCR ツールを入れておく必要がありますか？

通常は必要です。というのも、このスキルは環境で使える OCR 経路に依存するためです。リポジトリでは、フォールバック候補として macOS Vision、EasyOCR、Tesseract が挙げられています。visa-doc-translate を入れるなら、本番で使う前に環境を確認してください。特に macOS 以外で文書を扱う場合は重要です。

普通の翻訳プロンプトより優れていますか？

文書画像に対しては、はい。一般的なプロンプトでも文字の翻訳自体はできるかもしれませんが、回転補正、文字抽出、PDF 組み立ては見落とされがちです。visa-doc-translate は、官公文書で重要な処理 नियंत्रणを追加しています。変換、OCR フォールバック、構造保持、バイリンガル出力です。

使わないほうがいいのはどんなときですか？

ざっくり要約だけで足りるとき、入力がすでにきれいなテキスト PDF のとき、翻訳ではなく法的助言が必要なときには使わないでください。画像がひどく破損している、または判読不能な場合でも草案は作れる可能性がありますが、手作業での修正は前提にしたほうがよいです。

visa-doc-translate スキルを改善する方法

元画像をきれいにする

品質向上のいちばん大きな要因は、入力画像の質です。visa-doc-translate を実行する前に、不要な余白を切り取り、文字が読めることを確認し、部分的なスクリーンショットよりもページ全体の画像を優先してください。文書が横向きや上下逆だと分かる場合は、ファイル名や撮影状況から明らかであれば、その旨も明示するとよいです。

必ず保持したい内容を伝える

このスキルは、ビザ審査で重要な制約を指定すると強くなります。氏名は厳密に保持する、パスポート番号はそのまま残す、日付と通貨の表記は崩さない、正式なラベルは言い換えない、といった指示です。中国語の氏名をピンイン表記にしたい場合も、自然に推測されるだろうと期待せず、プロンプトで明確に指定してください。

出力を原本と照合する

最初の変換後は、PDF の訳文を原画像と見比べて、数字、日付、印章の文言、機関名を確認してください。もしずれがあれば、文書全体を再翻訳させるのではなく、該当する行や項目を具体的に示して修正を依頼したほうが効率的です。そのほうが、visa-doc-translate では「もっと正確にして」といった大ざっぱな指示より良い結果になります。

文書タイプの情報を加えてプロンプトを強化する

visa-doc-translate for Translation のワークフローは、銀行証明、在職証明、不動産証明のように、最初に文書カテゴリを伝えるだけでも精度が上がります。そうすると、より自然なビザ実務向けの用語を選びやすくなり、形式的な表現を平板な一般訳に落としてしまうことを避けられます。