Communitygithub.com

diegosouzapw/awesome-omni-skills

国際化・ローカライゼーションのワークフロースキルです。ハードコードされた文字列の検出、翻訳管理、ロケールファイル、RTLサポートなど、国際化・ローカライゼーションパターンが必要な場合に使用します。上流ワークフロー、コピーされたサポートファイル、出典情報をマージや引き継ぎ前に保持するよう注意してください。

awesome-omni-skills とは?

このスキルは、国際化 (i18n) とローカライゼーション (L10n) のベストプラクティスを実践するためのAIエージェント用ワークフローです。主に、上流のワークフローやサポートファイルの出典情報を維持しながら、ハードコードされた文字列の検出、翻訳キーの管理、ロケールファイルの構造化、RTL(右から左)言語のサポートなどを行います。このスキルは、`plugins/antigravity-awesome-skills/skills/i18n-localization` からインポートされたもので、`metadata.json` の `external_source` ブロックと `ORIGIN.md` によって出典情報が明確に管理されます。React(react-i18next)、Next.js(next-intl)、Python(gettext)などのフレームワークでの実装パターンや、ロケールファイルの構造例、よくある問題とその解決策も含まれています。このスキルは、主にClaude CodeやClineなどのAIエージェントプラットフォームでの使用を想定しており、オペレーターが上流ワークフローをそのまま活用しながら、レビュー可能な形で成果物を生成するのに役立ちます。

対応✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI✓OpenCode
npx skills add https://github.com/diegosouzapw/awesome-omni-skills/tree/HEAD/skills/i18n-localization-v2

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

i18n & Localization(国際化・ローカライゼーション)

概要

このパブリック取り込み用コピーは、https://github.com/sickn33/antigravity-awesome-skills の plugins/antigravity-awesome-skills/skills/i18n-localization を、その出典を隠すことなくネイティブのOmni Skills編集形式にパッケージ化したものです。

オペレーターが上流ワークフロー、サポートファイル、リポジトリコンテキストをそのまま維持しつつ、パブリックバリデーターとプライベートエンハンサーが通常のダウンストリームフローを続ける必要がある場合に使用します。

この取り込みは、コピーした上流ファイルをそのまま維持し、metadata.json の external_source ブロックと ORIGIN.md をレビュー用の出典情報アンカーとして使用します。

i18n & Localization(国際化・ローカライゼーション) > 国際化(i18n)およびローカライゼーション(L10n)のベストプラクティス ---

パブリック見出しにうまくマッピングできなかったインポート元のセクションは、以下またはサポートファイルにそのまま保存されています。注目すべきインポートセクション:1. コアコンセプト、3. 実装パターン、4. ファイル構造、6. よくある問題、7. RTLサポート、8. チェックリスト。

このスキルを使用するタイミング

このセクションをトリガーフィルターとして使用します。オペレーターがファイルをロードしたり、コマンドを実行したり、プルリクエストを開く前に、アクティベーション境界を明確にします。

  • プロジェクトタイプ - i18nが必要か?
  • パブリックWebアプリ - ✅ はい
  • SaaS製品 - ✅ はい
  • 内部ツール - ⚠️ 場合による
  • 単一リージョンアプリ - ⚠️ 将来を考慮
  • 個人プロジェクト - ❌ 任意

操作テーブル

状況開始場所重要性
初回使用metadata.jsonコピーしたワークフローに触れる前に、external_source ブロックを通じてリポジトリ、ブランチ、コミット、インポートパスを確認します
出典レビューORIGIN.mdレビュアーにインポート元の平易な監査証跡を提供します
ワークフロー実行scripts/i18n_checker.py実行に実質的な変更をもたらす最小のコピーファイルから開始します
サポートコンテキストscripts/i18n_checker.pyパッケージ全体をロードせずに、次に最も関連性の高いコピー元ファイルを追加します
引き継ぎ判断## 関連スキルタスクの性質が変わった場合に、より強力なネイティブスキルに切り替えるのに役立ちます

ワークフロー

このワークフローは、編集と運用を意図的に兼ねています。インポート元をオペレーターにとって有用に保ちつつ、ダウンストリームエンハンサーフローに供給するパブリック取り込み基準を満たします。

  1. ユーザーの目標、インポートされたワークフローの範囲、およびこのスキルがタスクに適したルーターかどうかを確認します。
  2. コピーされた上流サポートファイルをロードする前に、概要と出典ファイルを読みます。
  3. 現在のリクエストの結果に実質的な影響を与える参照、例、プロンプト、またはスクリプトのみをロードします。
  4. 出典とソースの境界を作業ノートに明示しながら、上流ワークフローを実行します。
  5. 上流の期待値と、コピーファイル内で指摘できる証拠に対して結果を検証します。
  6. 作業がこのインポートワークフローの中心領域から外れた場合は、関連スキルにエスカレーションまたは引き継ぎを行います。
  7. マージまたはクローズの前に、何を使用したか、何を変更したか、レビュアーがまだ確認すべき事項を記録します。

インポートされたワークフローノート

インポート:1. コアコンセプト

用語意味
i18n国際化 - アプリを翻訳可能にする
L10nローカライゼーション - 実際の翻訳
Locale言語 + 地域(en-US、tr-TR)
RTL右から左への言語(アラビア語、ヘブライ語)

例

例1:上流ワークフローを直接依頼する

@i18n-localization-v2 を使用して <task> を処理してください。コピーされた上流ワークフローから開始し、結果に影響を与えるファイルのみをロードし、出典情報を回答に明示してください。

説明: オペレーターがインポートされたワークフローは必要だが、リポジトリ全体は必要ない場合の最も安全な開始方法です。

例2:出典に基づいたレビューを依頼する

@i18n-localization-v2 を metadata.json と ORIGIN.md に照らしてレビューし、最初にどのコピーされた上流ファイルをロードするか、その理由を説明してください。

説明: レビューやトラブルシューティングの前に、正確で監査可能な出典とファイル選択の説明が必要な場合に使用します。

例3:実行前にコピーされたサポートファイルを絞り込む

<task> に @i18n-localization-v2 を使用してください。結果に影響を与えるコピーされた参照、例、またはスクリプトのみをロードし、ファイル名を明示してから実行してください。

説明: デフォルトでコピーパッケージ全体をロードするのではなく、段階的な開示に沿ってスキルを維持します。

例4:レビューパケットを作成する

@i18n-localization-v2 をコピーされた上流ファイルと出典情報を使用してレビューし、マージ前のギャップをまとめてください。

説明: PRが人間のレビューを待っており、再現可能な監査パケットが必要な場合に役立ちます。

ベストプラクティス

生成されたパブリックスキルは、上流リポジトリのレビュー可能なパッケージングレイヤーとして扱います。目標は、出典情報を明確にし、実行に実質的に貢献するコピー元の素材のみをロードすることです。

  • 生のテキストではなく翻訳キーを使用する
  • 翻訳を機能ごとに名前空間で区切る
  • 複数形に対応する
  • ロケールごとに日付/数値形式を処理する
  • 最初からRTLを計画する
  • 複雑な文字列にはICUメッセージ形式を使用する
  • コンポーネント内で文字列をハードコードしない

インポートされた運用ノート

インポート:5. ベストプラクティス

推奨事項 ✅

  • 生のテキストではなく翻訳キーを使用する
  • 翻訳を機能ごとに名前空間で区切る
  • 複数形に対応する
  • ロケールごとに日付/数値形式を処理する
  • 最初からRTLを計画する
  • 複雑な文字列にはICUメッセージ形式を使用する

禁止事項 ❌

  • コンポーネント内で文字列をハードコードする
  • 翻訳済み文字列を連結する
  • テキストの長さを想定する(ドイツ語は30%長い)
  • RTLレイアウトを忘れる
  • 同じファイルに言語を混在させる

トラブルシューティング

問題:オペレーターがインポートコンテキストをスキップし、汎用的すぎる回答を返した

症状: 結果が plugins/antigravity-awesome-skills/skills/i18n-localization の上流ワークフローを無視している、出典情報に言及していない、またはコピーされたソースファイルをまったく使用していない。 解決策: metadata.json、ORIGIN.md、および最も関連性の高いコピーされた上流ファイルを再度開きます。最初に external_source ブロックを確認し、続行する前に出典情報を再表明します。

問題:レビュー中にインポートされたワークフローが不完全に感じられる

症状: レビュアーは生成された SKILL.md を見ることができるが、現在のタスクにどの参照、例、スクリプトが重要かをすぐに判断できない。 解決策: 選択したパスを正当化する正確なコピーされた参照、例、スクリプト、またはアセットを指摘します。ギャップが実際に存在する場合は、PRに記録して隠蔽しないようにします。

問題:タスクが別の専門分野に逸脱した

症状: インポートされたスキルは正しい場所から始まったが、作業がデバッグ、アーキテクチャ、設計、セキュリティ、またはリリースオーケストレーションに変わり、ネイティブスキルの方が適している。 解決策: 関連スキルセクションを使用して、意図的に引き継ぎます。インポートされた出典情報を可視化したままにして、次のスキルが正しいコンテキストを継承できるようにします。

関連スキル

  • @00-andruia-consultant - このインポートスキルがコンテキストを確立した後、そのネイティブ専門分野で作業を処理する方が適切な場合に使用します。
  • @00-andruia-consultant-v2 - このインポートスキルがコンテキストを確立した後、そのネイティブ専門分野で作業を処理する方が適切な場合に使用します。
  • @10-andruia-skill-smith - このインポートスキルがコンテキストを確立した後、そのネイティブ専門分野で作業を処理する方が適切な場合に使用します。
  • @10-andruia-skill-smith-v2 - このインポートスキルがコンテキストを確立した後、そのネイティブ専門分野で作業を処理する方が適切な場合に使用します。

追加リソース

以下のサポートマトリックスとリンクファイルを、このインポートスキルのオペレーターパケットとして使用します。これらは、実際のコピーされたソース素材を反映している必要があり、汎用的な足場であってはなりません。

リソースファミリーレビュアーへの提供内容パスの例
references上流からコピーされた参照ノート、ガイド、背景資料references/n/a
examples上流からコピーされた実例や再利用可能なプロンプトexamples/n/a
scripts実行や検証を変更する上流ヘルパースクリプトscripts/i18n_checker.py
agentsインポートパッケージに実際に含まれるルーティングや委任ノートagents/n/a
assetsソースパッケージからコピーされたサポートアセットやスキーマassets/n/a

インポートされた参照ノート

インポート:3. 実装パターン

React(react-i18next)

import { useTranslation } from 'react-i18next';

function Welcome() {
  const { t } = useTranslation();
  return <h1>{t('welcome.title')}</h1>;
}

Next.js(next-intl)

import { useTranslations } from 'next-intl';

export default function Page() {
  const t = useTranslations('Home');
  return <h1>{t('title')}</h1>;
}

Python(gettext)

from gettext import gettext as _

print(_("Welcome to our app"))

インポート:4. ファイル構造

locales/
├── en/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── tr/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

インポート:6. よくある問題

問題解決策
翻訳の欠落デフォルト言語にフォールバック
ハードコードされた文字列リンター/チェッカースクリプトを使用
日付形式Intl.DateTimeFormat を使用
数値形式Intl.NumberFormat を使用
複数形ICUメッセージ形式を使用

インポート:7. RTLサポート

/* CSS論理プロパティ */
.container {
  margin-inline-start: 1rem;  /* margin-left ではない */
  padding-inline-end: 1rem;   /* padding-right ではない */
}

[dir="rtl"] .icon {
  transform: scaleX(-1);
}

インポート:8. チェックリスト

出荷前:

  • すべてのユーザー向け文字列が翻訳キーを使用している
  • サポートされているすべての言語のロケールファイルが存在する
  • 日付/数値の書式設定にIntl APIを使用している
  • RTLレイアウトがテストされている(該当する場合)
  • フォールバック言語が設定されている
  • コンポーネント内にハードコードされた文字列がない

インポート:スクリプト

スクリプト目的コマンド
scripts/i18n_checker.pyハードコードされた文字列と欠落している翻訳を検出python scripts/i18n_checker.py <project_path>

インポート:制限事項

  • このスキルは、タスクが上記で説明された範囲に明確に一致する場合にのみ使用してください。
  • この出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
  • 必要なインプット、権限、安全境界、成功基準が欠けている場合は、停止して明確化を求めてください。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AI UGC Ads workflow skill. Use this skill when the user needs When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Astro Web Framework workflow skill. Use this skill when the user needs Build content-focused websites with Astro \u2014 zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

frontend-design workflow skill. Use this skill when the user needs Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics. Do NOT use for design review or audit (use web-design-guidelines or web-quality-audit) and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Frontend Design (Distinctive, Production-Grade) workflow skill. Use this skill when the user needs You are a frontend designer-engineer, not a layout generator and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

i18n & Localization workflow skill. Use this skill when the user needs Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Paid Creative AI workflow skill. Use this skill when the user needs When the user wants to create AI-generated ad creative, test performance creative, manage creative fatigue, or optimize paid media with AI tools. Also use when the user mentions 'ad creative,' 'performance creative,' 'creative testing,' 'creative fatigue,' 'Meta ads,' 'Google ads,' 'TikTok ads,' 'AI ads,' 'ad budget,' 'ROAS,' 'Advantage+,' or 'Performance Max.' This skill covers AI-powered paid creative from generation through performance optimization. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

関連スキル