ログイン
← ブログ一覧

AIスキルにNode.jsやPythonは必要？手順書と実行環境を分けて考える

スキルを入れる前にNode.jsとPythonを両方そろえる必要はありません。SKILL.md、補助スクリプト、エージェント本体の違いを整理し、必要な環境だけを確認する方法を紹介します。

AI Skill Market · 公開 · 更新

「AIスキルを使いたいけれど、Node.jsとPythonのどちらを入れればいいのか」。まず見るのは、使いたいスキルの商品ページとREADMEです。両方を先回りしてインストールする必要はありません。

スキル、実行環境、エージェントは別のもの

SKILL.mdは、エージェントに作業手順や注意点を伝える文書です。スキルのフォルダーには参考資料やテンプレート、任意の補助スクリプトも入ります。Agent Skills仕様でも、scriptsは任意です。

Node.jsやPythonは、その補助スクリプトを動かす実行環境です。READMEがNode.jsで実行するよう指定した.js・.mjsなら対応するNode.js、.pyならPythonが必要です。一方、エージェント本体は指示を読み、利用できるツールを呼び出す側です。Node.jsで動くエージェントだからといって、使うスキルがすべてNode.js製になるわけではありません。

必要なものの早見表

次の表は、スキルが追加で求める環境の目安です。エージェント本体の動作条件は別に確認してください。

スキルの中身       | 追加で確認するもの
手順書のみ         | Node.js・Pythonが不要な場合もある
Python補助スクリプト | 指定されたPythonと依存パッケージ
Node.js補助スクリプト| 指定されたNode.jsと依存パッケージ
両方を呼ぶ構成     | 説明に明記されている場合だけ両方

マーケットの「必要な実行環境」は入口です。細かなバージョン、追加パッケージ、対応OS、任意の機能は、実物のSKILL.mdやREADMEまで読んで確認します。表示が「なし」でも、あらゆる道具が不要という意味ではありません。

たとえば商品写真キャンペーン制作キットは、実行環境が「なし」の例です。同梱SKILL.mdは画像を実際に生成・編集できるツールを求めています。ローカルのNode.jsやPythonが不要でも、画像を見るだけの機能では代用できません。ChatGPT等で手順書を渡す使い方と、スキルフォルダーの自動検出も別です。

AIスキル導入前のリスク点検はPythonの例です。商品ページと実物のSKILL.mdはPython 3.10以上・標準ライブラリのみを指定しています。Node.jsのコードも読み取りますが、対象を実行しないためNode.jsは不要です。「3.10以上」はこのスキルの条件で、全スキル共通の条件でも、3.10自体の導入推奨でもありません。互換性と公式のサポート状況を確認して選びます。

まずはバージョンだけ確かめる

WindowsではPowerShellやターミナルで、必要なものだけ次のコマンドを実行します。インストールや更新はしません。npmはNode.jsのパッケージ管理ツールで、使うかどうかもREADME次第です。

node --version
npm --version
python --version

Windowsでpyが利用できる場合は、こちらも確認できます。

py --version

MacではPythonのコマンド名がpython3の場合があります。

python3 --version

この記事ではWindows上のエージェントのターミナルで、node・npm・python・pyの確認を実行しました。pythonとpyが異なる版を返すことも確認しています。Macは公式資料の確認のみで、実機検証はしていません。表示された版が要件を満たすかは、スキルごとに判断します。

商品ページ → SKILL.md / README → 実行する場所を確認
          → 必要なランタイムの版を確認 → 内容と権限を点検
          → 許可した小さな入力で試す

見つからないときは、入れ直す前に実行場所を確認

「コマンドが見つからない」は、未導入だけでなく、PATHに実行ファイルの場所が含まれていない場合にも起きます。PATHはコマンドを探すフォルダーの一覧です。設定を変えた後も、起動済みのアプリが古い環境を引き継いでいることがあります。新しいターミナルやエージェントの再起動後に再確認してください。

サーバーやコンテナーにPythonがあっても、利用者のWindowsで使えるとは限りません。逆も同じです。エージェントが実際に補助スクリプトを実行する場所で確認します。仮想環境によってPythonやパッケージが分かれる点にも注意が必要です。版は出るのにモジュールがない場合は、READMEと選択中の環境を照合し、むやみに追加しないでください。

入手先とZIPの境界

必要とわかったときの入手先はNode.js公式ダウンロードとPython公式ダウンロードです。この記事ではソフトウェアの導入・更新は行っていません。出品ZIPに.exeを同梱せず、必要な外部ソフトは公式配布元と条件を案内します。ZIPへの実行ファイル同梱禁止は、必要なソフトを公式サイトから別途導入することまで禁じるものではありません。

導入前には配布元、コード、権限も確認します。前述の無料点検スキルは判断材料を出すもので、指摘なしでも安全の保証にはなりません。不明な候補のコードを、確認のために起動しないでください。フォルダーの配置方法はWindows・Mac別のインストールガイドへ。

公式資料