スキル

Showly スキル

エージェント機能へのユーザーに見えるインターフェイスとしてのスキル。

Showly は、MCP サーバーをタスク指向のプロンプトでラップする公式 Claude Code スキル を公開しています。スキルは、エージェントから Showly を使用する最も簡単な方法です。スキルをインストールすると、エージェントは Showly ツールを呼び出すタイミングを自動的に認識し、プロンプトはパブリッシュループ規則をすでにエンコードしています。

なぜスキルなのか

生の MCP サーバーはエージェント ツールを提供します。スキルは、エージェントに「いつ」と「なぜ」使用するかを教えます。 Showly スキルには次のものが含まれます。

  • 意図に応じてトリガーされる説明 (「デプロイ」、「公開」、「プレビュー」、「表示」)。
  • create_change_plan → apply_site_patch → create_preview → run_checks → request_publish と連鎖する内部スクリプト。エージェントはその必要がありません。
  • プレビュー URL を読み取り、レポートを返す検証手順。
  • エージェントが単独で実行すべきではないアクションの拒否パターン (本番パブリッシュは常に承認ゲートを経由して人間に送信されます)。

公式スキルのインストール

Claude Code (または Codex) の場合:

npx @showly/mcp-server install --to claude-code   # or --to codex

このコマンドは @showly/mcp-server パッケージをインストールし、Showly MCP サーバーを登録します。トークンを手動で設定する必要はありません。Showly ツールを初めて呼び出すと、エージェントがブラウザーを開き、サインインとアクセス許可を求めます。その後、Showly が標準 MCP OAuth を使ってスコープ付きトークンをエージェントへ直接発行します。詳しい認可フローとブラウザーを使えない場合の手順は、スキルのインストールを参照してください。

raw MCP にはないスキルの機能

  • リポジトリの GitHub リモートと Showly ワークスペース内のサイトを照合することにより、現在の作業ディレクトリからアクティブ サイトを 自動検出します。
  • Playwright MCP もインストールされている場合、mcp__playwright_browser_take_screenshot のスクリーンショットを使用してプレビューをインラインでレンダリングします。
  • 最近通過したプレビューなしでの公開リクエストを拒否します。制作公開は常に request_publish と人間の承認を経て行われます。

自動検出

チェックアウトされたリポジトリ内でエージェントを実行すると、スキルはリポジトリの origin リモートを読み取り、ワークスペース内で repositoryUrl が一致するサイトを探します。一致したサイトの siteId は、get_site_context、apply_site_patch、create_preview、およびループの残りのターゲットになるため、手動でサイトに名前を付ける必要はほとんどありません。

リモートに一致するサイトがない場合、スキルは推測ではなくサイトを選択または作成するように求めます。複数のサイトがリモートを共有している場合は、曖昧さを解消するよう求められます。

ガードレールを公開する

制作物がエージェントから直接公開されることはありません。公開をリクエストする前に、スキルは次のことを確認します。

  • サイトには最近 ready プレビュー展開があります。
  • run_checks はそのプレビューに対して合格しました。

これらが成立すると、スキルは request_publish を呼び出し、webApprovalUrl ディープリンクを返します。管理者権限を持つ人間が Web UI でリクエストを承認します。エージェントは承認状態をポーリングするだけです。人間のステップを経ずに本番環境に移行するエージェント パスはありません。

次のステップ