コーディングエージェントに potato-skill をインストールする
Claude Code、Codex、Cursor などのコーディングエージェントに potato-skill をインストールします。エージェントごとのインストールコマンドとスキルフォルダーも示します。
potato-skill はエージェントスキル（Agent Skill）です。指示とヘルパースクリプトをまとめたフォルダーで、この形式に対応するコーディングエージェントなら読み込めます。Claude Code は potato-skill をプラグインとしてインストールし、ほかのエージェントは npx skills add davidjurgens/potato-skill でフォルダーを受け取ります。--agent の後ろにはエージェント名を付けます。 Claude Code、Codex、Cursor には、それぞれ専用のセットアップページがあります。スキルが研究をどう扱うかは、コーディングエージェントでのクイックスタートで説明しています。
エージェント別のインストールコマンド
| エージェント | インストール | エージェントが読むフォルダー | セットアップページ |
|---|---|---|---|
| Claude Code | /plugin marketplace add davidjurgens/potato-skill、続けて /plugin install potato-skill@potato | Claude Code のプラグインキャッシュ | Claude Code |
| Codex | npx skills add davidjurgens/potato-skill --agent codex | .agents/skills/ | Codex |
| Cursor | npx skills add davidjurgens/potato-skill --agent cursor | .agents/skills/ | Cursor |
| VS Code の GitHub Copilot | npx skills add davidjurgens/potato-skill --agent github-copilot | .agents/skills/ | 下記 |
| Gemini CLI | npx skills add davidjurgens/potato-skill --agent gemini-cli | .agents/skills/ | 下記 |
| OpenCode | npx skills add davidjurgens/potato-skill --agent opencode | .agents/skills/ | 下記 |
potato-skill は Claude Code 向けに書かれており、スキルの SKILL.md には Codex と Cursor のインストール先フォルダーも書かれています。GitHub Copilot、Gemini CLI、OpenCode は同じファイルを読み込みます。アノテーターを招待する前に、エージェントが最初に作ったタスクをブラウザーで開き、自分で数項目にラベルを付けてみてください。
インストールの前に
Potato は、エージェントのシェルが使う Python 環境に入れます。スキルのヘルパースクリプトは Potato のレジストリをインポートして potato コマンドを呼び出し、スキルの最初のステップでは Potato をインポートできるかを確認します。ブラウザー用の extra と Chromium があると、potato preview --screenshot とスキルのウォークスルースクリプトがヘッドレスブラウザーでタスクを開けます。
pip install 'potato-annotation[preview]'
playwright install chromiumskills CLI は npx で動きます。CLI のバージョン 1.7.6 には Node.js 22.20 以降が必要です。
skills CLI が書き込むもの
npx skills add は、SKILL.md、30 個のリファレンスファイル、9 個のヘルパースクリプトを .agents/skills/potato-skill/ にコピーし、取得元をプロジェクトルートの skills-lock.json に記録します。-g を付けると ~/.agents/skills/potato-skill/ にインストールされ、そのマシン上のすべてのプロジェクトで使えます。Codex、Cursor、VS Code の GitHub Copilot、Gemini CLI、OpenCode はいずれも .agents/skills/ を読みます。1 つのコマンドでこれらのエージェントを複数指定でき、その場合は各エージェントが 1 つのコピーを共有します。
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencodeCLI が対応するほかのエージェントの --agent 名とフォルダーは、CLI のエージェント一覧表にあります。このページに出てくるエージェントはどれも、アノテーションタスクの構築の依頼など、リクエストがスキルの説明に合うときは、コマンドなしでもスキルを読み込みます。
VS Code の GitHub Copilot
VS Code はローカルセッションで、Copilot 独自の .github/skills/ に加えて .agents/skills/ と .claude/skills/ を読みます。スキルはチャットでもエージェントモードでも動作します。チャットに /potato-skill と入力するとスキルが始まります。
Gemini CLI
Gemini CLI は、ワークスペースの .agents/skills/ とユーザーの ~/.agents/skills/ を読みます。/skills list で、Gemini が見つけたスキルが表示されます。Gemini は、リクエストが合えばコマンドなしでスキルを開始し、スキルを会話に読み込む前に確認を求めます。
OpenCode
OpenCode は、現在のフォルダーから git ワークツリーまでの各フォルダーにある .agents/skills/ を読み、グローバルインストールでは ~/.agents/skills/ を読みます。エージェントは、OpenCode の skill ツールを通じて、合致するスキルを読み込みます。
skills CLI を使わない場合
potato-skill リポジトリのルートには AGENTS.md があります。スキルの規則を短くまとめたもので、Codex と Cursor はファイル名で読み込みます。このファイルをプロジェクトルートにコピーすると、インストール手順なしでエージェントに規則を渡せます。ただし、このファイルが指すリファレンスファイルとスクリプトは、完全インストールでしかディスクに置かれません。完全インストールと AGENTS.md のコピーの比較は、コーディングエージェントでのクイックスタートにあります。リファレンスファイルは davidjurgens.github.io/potato-skill でも公開されています。Web ページを読めるエージェントは公開されたコピーを使えますし、インストール前にそこでファイルを読むこともできます。
スキルの更新と削除
skills CLI は、名前を指定してスキルを更新・削除します。グローバルインストールの場合は、どちらのコマンドにも -g を付けます。
npx skills update potato-skill
npx skills remove potato-skillupdate は、インストール済みのコピーを GitHub リポジトリと照合し、リポジトリに変更があればコピーを置き換えます。remove は .agents/skills/potato-skill/ と、skills-lock.json にあるスキルのエントリを削除します。プラグインの更新と削除のコマンドは、Claude Code のページにあります。