Communitygithub.com

diegosouzapw/awesome-omni-skills

国際化(i18n)とローカリゼーション(L10n)のワークフロースキル。ハードコードされた文字列の検出、翻訳管理、ロケールファイル、RTLサポートが必要な場合に使用します。上流ワークフロー、コピーされたサポートファイル、およびプロvenanceをマージまたは引き継ぎ前に保持する必要があります。

awesome-omni-skills とは?

このスキルは、`plugins/antigravity-awesome-skills-claude/skills/i18n-localization` パッケージを Omni Skills のエディトリアル形式にラップしたものです。元のリポジトリからのインポート経路を隠蔽せず、`metadata.json` の `external_source` ブロックと `ORIGIN.md` を証明のアンカーとして保持します。 主な機能として、上流のワークフロー、サポートファイル、リポジトリコンテキストをそのまま維持しながら、パブリックバリデーターとプライベートエンハンサーが通常の下流フローを続行できるようにします。対象プロジェクトはパブリックWebアプリ、SaaS製品などで、内部ツールや個人プロジェクトではオプションまたは不要としています。 スキルは、最初に `metadata.json` でリポジトリとインポートパスを確認し、次に `ORIGIN.md` で監査証跡を提供します。ワークフロー実行には `scripts/i18n_checker.py` を使用し、コアコンセプト(i18n、L10n、ロケール、RTL)、実装パターン(React、Next.js、Python)、ファイル構造、RTLサポート(CSS Logical Properties)、チェックリストなどのインポートされたセクションを保持しています。 トラブルシューティングでは、上流コンテキストの無視やワークフローの不完全さ、タスクの専門外への逸脱に対処します。関連スキル(`@00-andruia-consultant` など)への引き継ぎもサポートされており、レビュー担当者向けにコピーされた参照、例、スクリプト、アセットのリソースマトリクスも提供します。

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

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

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

ドキュメント

i18n & ローカリゼーション

概要

このパブリック取り込みコピーは、https://github.com/sickn33/antigravity-awesome-skills の plugins/antigravity-awesome-skills-claude/skills/i18n-localization を、Omni Skills のネイティブエディトリアル形式にパッケージ化したものです。その出所を隠蔽することはありません。

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

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

i18n & ローカリゼーション > 国際化(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ローカリゼーション - 実際の翻訳
ロケール言語 + 地域 (en-US, tr-TR)
RTL右から左へ記述する言語 (アラビア語、ヘブライ語)

例

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

@i18n-localization を使用して <タスク> を処理してください。コピーされた上流ワークフローから開始し、結果を変更するファイルのみをロードし、回答に証明を可視化したままにしてください。

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

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

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

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

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

@i18n-localization を <タスク> に使用してください。結果を変更するコピーされた参照、例、またはスクリプトのみをロードし、事前にファイル名を明示してください。

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

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

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

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

ベストプラクティス

生成されたパブリックスキルは、上流リポジトリのレビュー可能なパッケージングレイヤーとして扱います。目標は、証明を明示的に保ち、実行を実質的に改善するコピー元のソースマテリアルのみをロードすることです。

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

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

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

✅ 推奨事項

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

❌ 禁止事項

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

トラブルシューティング

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

症状: 結果が plugins/antigravity-awesome-skills-claude/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 Logical Properties */
.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.

関連スキル