Skip to content

コーディングエージェントスキル ​

1回のインストールですべてのコンシューマースキルがコピーされます。共有スキルは、エージェントにsyncを使用してai-i18n-toolsをインストールおよび保守する方法を教え、タスクに一致するリファレンスのみをロードします。各ワークフローは、/ai-i18n-vitepressのような個別のスラッシュコマンドです。

npmパッケージまたはスタンドアロン実行可能ファイルをインストールしても、スキルは登録されません。各エージェントには1つのインストール方法を使用してください。

skills CLI によるインストール ​

これは、Node.jsが22.20以降の場合に使用するインストール方法です。このパッケージ自身のCLIはNode.js 22.16を許可しますが、これはskills CLIには古すぎます。22.16から22.19の場合、またはNode.jsがインストールされていないマシンでは、スキルディレクトリをダウンロードするを使用してください。

エージェントに作業させたいプロジェクトから:

bash
npx skills add wsj-br/ai-i18n-tools

このコマンドは、共有スキルと各ワークフローコマンドを含む、skills/以下のすべてのディレクトリをインストールします。このリポジトリのチェックアウトをプロジェクトに残しません。デフォルトのスコープは現在のプロジェクトです。プロジェクト全体でユーザー用にインストールするには、-gを追加します。

bash
npx skills add wsj-br/ai-i18n-tools --all -y
npx skills add wsj-br/ai-i18n-tools --list
npx skills add wsj-br/ai-i18n-tools --skill ai-i18n-vitepress -a cursor
npx skills update

--all -yはワンステップインストールです: すべてのスキル、プロンプトなし。--allがない場合、インストーラーはどのスキルをコピーするかを尋ねます。--listはスキルを表示し、何もインストールしません。--skillと-aは、1つのスキルと1つのエージェントのプロンプトをスキップします。npx skills updateはこの方法でインストールされたスキルを更新します。最初のインストール後にスキルが追加された場合は、addを再度実行してそのスキルを認識させます。

インストールせずに、スキルをプロンプトとして表示したり、サポートされているエージェントで起動したりするには:

bash
npx skills use wsj-br/ai-i18n-tools@ai-i18n-tools

CLIは、マシンにインストールされているコーディングエージェントを検出します。各エージェントのインストールパスは、skills CLIエージェントリストにあります。このリストは変更されます。このページではそれを繰り返さず、すべてのコーディングツールがスキルフォルダーを読み取るとは主張しません。

skills CLIは匿名の使用状況データを収集します。それをオフにするには、DISABLE_TELEMETRY=1またはDO_NOT_TRACK=1を設定します。

インストール後、その製品がリロードを必要とする場合は、新しいエージェントセッションを開始してください。/ai-i18n-vitepressのようなワークフローコマンドを入力するか、エージェントにai-i18n-toolsスキルを使用するように依頼します。共有スキルは、コマンド名を指定しないリクエストのフォールバックです。発見されたスキルが、エージェントがそれを自律的に呼び出すことを保証するものではありません。

スラッシュコマンド ​

共有のai-i18n-toolsスキルはエージェントに利用可能なままです。他のスキルは明示的なコマンドです。それぞれが共有スキルに従い、そのテンプレートとチェックのみを適用します。

コマンドワークフロー
/ai-i18n-jsJavaScriptまたはTypeScriptのソース文字列UI
/ai-i18n-python生成されたPythonヘルパーとフラットJSONカタログ
/ai-i18n-dotnet生成された I18n.cs または I18nResx.cs、および migrate-dotnet-i18n
/ai-i18n-djangoDjango、Flask-Babel、またはプレーンなgettext
/ai-i18n-vitepressVitePress
/ai-i18n-starlightAstro Starlightドキュメント
/ai-i18n-docusaurusDocusaurus
/ai-i18n-nextraNextra
/ai-i18n-fumadocsFumadocs
/ai-i18n-astro-websiteVanilla Astro ウェブサイト
/ai-i18n-plain-html1つのHTMLファイル、ブラウザで切り替え
/ai-i18n-plain-html-docsロケールごとに1つのHTMLツリー
/ai-i18n-readmeREADMEとリポジトリのMarkdown
/ai-i18n-migrate-intlayerIntlayerからt()呼び出しへの1回限りの移行
/ai-i18n-translate-intlayerIntlayer辞書をその場で埋める

.agents/skills/または.cursor/skills/にコピーされたスキルは、これらのコマンドとして表示されます。現在のCursorのバグにより、disable-model-invocationを設定するマーケットプレイスプラグインのスキルが/パレットから非表示になります。Claude Code、Codex、Copilotでは、それらのコマンドは引き続き表示されます。Cursorでコマンドが必要な場合は、スキルCLIインストールを使用してください。自然言語のリクエストは、共有スキルには引き続き到達します。

スキルディレクトリをダウンロードする ​

スキルCLIが利用できない場合は、これを使用してください。ai-i18n-tools/だけでなく、すべてのスキルディレクトリをコピーしてください。各ワークフローコマンドは、SKILL.mdを含む独自のフォルダです。1つのスキルパスのgit cloneとnpx degitは、どちらも約50 MBのリポジトリソースアーカイブをダウンロードします。

スキルCLIエージェントリストから1つのエージェントディレクトリを選択してください。以下の例では、複数のエージェントが読み取る.agents/skills/を使用しています。既存のコピーを置き換える前に、その宛先を検査してください。エージェントごとに1つのコピーで十分です。同じエージェントに対して別の検出フォルダに2つ目のコピーがある場合、それは重複です。

npmパッケージにはすでにディレクトリが含まれています。パッケージがインストールされている場合:

bash
mkdir -p .agents/skills
cp -a node_modules/ai-i18n-tools/skills/. .agents/skills/

node_modulesがない場合は、CLIが報告するのと同じバージョンのnpm tarballをダウンロードしてください。ai-i18n-tools --versionはバージョン、次にビルドタイムスタンプを出力します。バージョン番号のみを使用してください。tarballのメンバーはpackage/skills/です。

bash
mkdir -p .agents/skills
curl -fsSL https://registry.npmjs.org/ai-i18n-tools/-/ai-i18n-tools-1.12.0.tgz \
  | tar -xz --strip-components=2 -C .agents/skills package/skills

1.12.0をインストールされているバージョンに置き換えてください。これは現在のリリースで機能します。スタンドアロン実行可能ファイルにはスキルファイルは含まれていません。tarballをai-i18n-tools --versionに合わせてください。

それを含むリリースから、GitHub Releasesもai-i18n-tools-skill.zipを添付します。そのzipファイルには、すべてのスキルディレクトリがトップレベルに含まれています。結果としてai-i18n-tools/SKILL.mdとai-i18n-vitepress/SKILL.mdのようなワークフローフォルダの両方が含まれるように、それをエージェントのスキルフォルダに解凍してください。そのzipファイルより前に公開されたリリースには、それは含まれていません。古いzipファイルにはai-i18n-tools/のみが含まれています。それらのリリースにはnpm tarballを使用してください。タグはvとCLIバージョンです。例えば、そのタグのリリースにアセットがある場合、v1.12.0となります。

スキルCLIがインストールするエージェント ​

1つのエージェントが必要な場合は、IDを-aに渡してください。これらのツールに対して、このリポジトリには他には何も必要ありません。

CLIエージェント:Claude Code (claude-code)、Codex CLI (codex)、Gemini CLI (gemini-cli)、Antigravity CLI (antigravity-cli)、GitHub Copilot CLI (github-copilot)、OpenCode (opencode)、Goose (goose)、Qwen Code (qwen-code)、Kilo CLI (kilo)、Grok Build (grok)、Amp (amp)、Crush (crush)、Pi (pi)、Kiro CLI (kiro-cli)。

エディターとIDE:Cursor (cursor)、Windsurf (windsurf)、Devin for Terminal (devin)、Zed (zed)、Antigravity (antigravity)、Trae (trae)、Junie (junie)、Replit (replit)、Cline (cline)、Roo Code (roo)、Kilo Code (kilo)、Continue (continue)、Augment (augment)、Factory Droid (droid)、Tabnine CLI (tabnine-cli)。エディター内のGitHub Copilotは、CLIと同じgithub-copilot IDを使用します。

見落としがちな2つのパスの詳細:

  • Cursor: skills CLIからのプロジェクトインストールは.agents/skills/に配置されます。-gは~/.cursor/skills/に配置されます。Cursor自身のドキュメントも、プロジェクト内で.cursor/skills/を受け入れます。これらのいずれかを使用してください。
  • GitHub Copilot: skills CLIはプロジェクトに.agents/skills/を、-gには~/.copilot/skills/を書き込みます。GitHubのクラウドエージェントのドキュメントも.github/skills/について説明しています。そのフォルダーはすべてのCopilotチャットで読み込まれるわけではありません。使用するインターフェース向けにドキュメント化されているフォルダーのみを使用してください。

Kiro CLIのデフォルトエージェントは、追加の設定なしで.kiro/skills/と~/.kiro/skills/をロードします。カスタムKiroエージェントは、.kiro/agents/<agent>.jsonにリストされているインストール済みのスキルを必要とします:

json
{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

ネイティブカタログ ​

一部の製品は、このリポジトリ内のカタログからスキルをインストールします。各エージェントには、カタログまたはskills CLIのいずれか1つのチャネルを使用してください。パッケージのアップグレードでは、手動でコピーされたスキルは更新されません。npx skills updateはskills CLIのインストールを更新します。カタログからのインストールは、その製品の更新コマンドに従います。

  • Cursor Marketplace(リスティング承認後):Cursor Marketplaceからai-i18n-toolsをインストールします。そのリスティングが存在するまでは、skills CLIを使用してください。Cursor Directoryは別のコミュニティリスティングです。
  • Claude Code(Claude Codeセッションから):
text
/plugin marketplace add wsj-br/ai-i18n-tools
/plugin install ai-i18n-tools@ai-i18n-tools
  • GitHub Copilot CLI:
bash
copilot plugin marketplace add wsj-br/ai-i18n-tools

そのマーケットプレイスからai-i18n-toolsプラグインをインストールします。プラグインIDはai-i18n-tools@ai-i18n-toolsです。Copilot CLIは、Claude Codeが使用するのと同じカタログファイルを読み込みます。

  • Codex:
bash
codex plugin marketplace add wsj-br/ai-i18n-tools

ChatGPTワークスペースのリスティングは、ワークスペース管理者によって別途公開されます。これは、このコマンドとは異なるインストールです。

スキルインストールなしのエージェント ​

これらの製品はskills CLIエージェントリストには含まれていません。このリポジトリは、これらの製品用の個別のスキルフォルダーを提供していません。エージェントを、AGENTS.mdのようなプロジェクトの指示からコンシューマーコンテキストに指定してください:

markdown
Before installing or maintaining ai-i18n-tools, read
https://github.com/wsj-br/ai-i18n-tools/blob/main/docs/ai-i18n-tools-context.md
and follow only the linked reference that matches this project.
Use ai-i18n-tools sync for the configured workflow.

そのファイルはドキュメントサイトとリポジトリのURLを使用しているため、エージェントがこのリポジトリを読み取れない場合でも、その指示は機能します。古いCLIの場合は、対応するリリースタグで同じパスを開いてください。コンシューマープロジェクトはこのコンテキストファイルを使用します。このリポジトリを変更する際には、メンテナーのAGENTS.mdが適用されます。

このグループの製品:Aider、gptme、Amazon Q Developer CLI、DeepSeek Harness、JetBrains AI Assistant、Sourcegraph Cody、Qodo、Tabnine IDEプラグイン、CodeGeeX、およびAskCodi。Junieはskills CLIインストールを受け入れるJetBrainsエージェントです。Tabnine CLIも同様です。AiderDeskはAiderとは異なるアプリケーションです。

CodeLayerとSupersetは独自のスキルディレクトリを持っていません。CodeLayerはClaude Codeを実行するため、Claude Code用のスキルをインストールしてください。Supersetは設定したCLIエージェントを実行するため、それらのエージェント用のスキルをインストールしてください。

同じバージョンを維持する ​

スキルはai-i18n-toolsコマンドと同じリリースバージョンに保ってください。npmのアップグレードや新しいスタンドアロン実行可能ファイルは、手動でコピーされたスキルを元の場所に残します。対応するバージョンからスキルを再度インストールするか、skills CLIのインストールにはnpx skills updateを実行してください。

オンラインドキュメントには、インストールされているコマンドよりも新しいリリースが記載されている場合があります。フラグにはai-i18n-tools --helpを推奨します。詳細な参照:インストール、設定、プロバイダー、CLIリファレンス。

MITライセンスの下で公開されています。