スキル

CLI、SDK、OpenRouter の三経路で InsForge に接続する

代理に InsForge でバックエンドアプリを作らせたい人向け。先に公式 skills add を入れる。バックエンドは CLI スキル、クライアントは SDK、新しい AI 機能は先に ai setup。診断は位置特定だけで修復は出さない。

公式ソース · insforge-skills

インストール

npx -y skills add insforge/insforge-skills

誰向けか

AI 代理に、Backend-as-a-Service の InsForge を使ってアプリを作らせたいときに、このスキル一式を使う。原文は、開発者が代理を通じてアプリを構築する助けになると書く。製品ページは

https://insforge.dev/

スキルリポジトリは

https://github.com/insforge/insforge-skills

原文の重要な区別:バックエンド基盤は CLI スキルを使う。ほとんどのクライアント統合は @insforge/sdk を使う。新しい AI 機能は OpenRouter API を使い、鍵は npx -y @insforge/cli ai setup で設定する。このマシンで公式インストールを実行する準備が無い、またはスキルファイル書き込みを受け入れないなら、先に続けない。

診断スキルもある:診断コマンドの実行を指導して問題を特定し、修復提案は出さない。直接コードを変えるとは期待しない。原文はバックエンド能力を機能目録へ広げていない。具体的な業務操作を自分で足さない。ブラウザで InsForge をクリックするだけで、代理に CLI スキルや SDK で配線させる準備が無い人は、ここから始める必要も無い。

3 分で最初の試行を終える

先に公式リポジトリを開いて照合する:

https://github.com/insforge/insforge-skills

推奨インストールはこの一本だけ。スキルを入れるとこのマシンのスキルディレクトリが変わる。実行前に、InsForge スキルを残すか確認する:

npx -y skills add insforge/insforge-skills

成功の合図はこのコマンドが正常に終わること。原文はスキルの着地経路を書いていない。ディレクトリを自分で足さない。原文には特定クライアント向けのプラグイン市場の入れ方もある。最初はそれを第二の主経路として並列にしない。説明していない環境へ市場コマンドを当てはめない。

代理では最初は照合だけ。先に ai setup を走らせない。診断サブコマンドも作らない。代理に重要な区別を復唱させる:バックエンド基盤は CLI スキル、クライアント統合は主に @insforge/sdk、新しい AI 機能は OpenRouter、診断は問題の特定だけで修復提案は出さない。観察点は、この三経路をはっきり言え、まだ鍵を設定しておらず、出ていない修復も実行していないこと。

ai setup は API 鍵を設定する。副作用がある。新しい AI 機能向けに OpenRouter 鍵を残すと確認したときだけ実行する:

npx -y @insforge/cli ai setup

原文は鍵のフィールド名を書いていない。プレースホルダの鍵を書かない。最初は診断スキルを自動修復だと思わない。代理が、出ていない診断コマンドを実行すると言い出したら、先に「原文は位置特定の指導までしか書いておらず、コマンド目録は無い」と言わせてから止める。

利用事例

事例一:公式入口どおりスキルを入れる。skills add を受け取れる代理で、スキルファイル書き込みを受け入れたあと、npx -y skills add insforge/insforge-skills だけを実行する。InsForge スキルを代理へつなぐだけで、まだ鍵を設定する準備が無い人向け。成功の合図はインストールコマンドが正常に終わり、代理が InsForge Backend-as-a-Service 用だと言えること。インストールが失敗したら止める。プラグイン市場を予備の主経路に切り替えない。

事例二:先に配線を照合し、AI 鍵を設定するか決める。入れたあと、代理に復唱させる:バックエンド基盤は CLI スキル、ほとんどのクライアント統合は @insforge/sdk、新しい AI 機能は OpenRouter API、鍵は npx -y @insforge/cli ai setup で設定する。診断スキルは問題の特定だけで修復提案は出さない。代理がすぐネットに出たりバックエンドを勝手に変えたりすることを心配する人向け。成功の合図は三経路の区別と診断境界が両方はっきり言えること。本当に ai setup を実行する前に、鍵を残すと確認する。原文に診断コマンド目録は無い。作らない。「開発者のアプリ構築を助ける」を、作成や移行の具体手順がすでに出たことだと理解しない。

利用上の境界

主経路は npx -y skills add insforge/insforge-skills だけ。原文はプラグイン市場インストールも書いた。それは最初の試行の主経路ではない。並列にしない。製品ページは

https://insforge.dev/

三経路の区別を守る:バックエンド基盤は CLI スキル、クライアント統合は主に @insforge/sdk、新しい AI 機能は OpenRouter で先に ai setup を終える。診断スキルは問題の特定を指導するだけで修復提案は出さない。原文は具体的なバックエンド操作目録を広げていない。スキルディレクトリ、鍵フィールド、アンインストール手順も書いていない。書いていない業務動作、修復コマンド、クライアント名簿を補わない。最初の成功はインストール終了と代理が区別を復唱できることだけ。鍵の設定や診断実行の前に副作用を確認する。代理が修復手順を出し始めたら先に止め、「問題の特定だけ」へ戻る。新しい AI 機能は ai setup が終わる前に OpenRouter がもう接続済みだと装わない。クライアント統合で @insforge/sdk を迂回し、別の SDK 名を作らない。バックエンド基盤も、出ていないインストーラへ切り替えない。根拠にアンインストールや更新経路は無い。コマンドを自分で足さない。最初の成功はインストール終了と、代理が CLI スキル、SDK、OpenRouter の三経路をはっきり言えることだけを求める。