Communitygithub.com

wildematt/phone-preview-skill

📱 Craft Agent スキル: ローカルのライブリロード開発サーバーを起動し、モバイルプレビュー用のQRコードを生成します。

phone-preview-skill とは?

このスキルは、Craft Agent などのAIエージェント(またはCLI)から、ローカル開発サーバーを起動し、スマートフォンでプレビューするためのQRコードを生成する機能を提供します。ライブリロードが有効なため、コード変更時にブラウザが自動更新され、モバイルでのテストが効率的に行えます。主に静的サイトやフロントエンドプロジェクトの開発時に、デスクトップ上の変更を即座にスマホで確認したい場面で役立ちます。対応プラットフォームは Craft Agent および一般的なターミナル環境です。サーバーは指定されたポートで起動し、QRコードがターミナルに表示されるため、ユーザーはスマートフォンでそのコードをスキャンするだけでアクセスできます。

対応~Claude Code~Codex CLI~Cursor
npx skills add wildematt/phone-preview-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

phone-preview-skill は何をしますか?

📱 Craft Agent スキル: ローカルのライブリロード開発サーバーを起動し、モバイルプレビュー用のQRコードを生成します。

使い方

このスキルは、Craft Agent またはコマンドラインから直接実行できます。

# Craft Agent からの使用例 (エージェントが自動呼び出し)
/phone-preview

または、以下のように直接スクリプトを実行します。

./start-preview.sh

動作

  1. 指定されたディレクトリ(デフォルト: カレントディレクトリ)で HTTP サーバーを起動します。
  2. ライブリロード機能を有効にし、ファイル変更時に自動でリロードします。
  3. サーバーのURL(例: http://localhost:3000)をQRコードに変換して表示します。
  4. ターミナルにQRコードが表示されるので、スマートフォンでスキャンしてアクセスします。

必要なツール

  • Node.js (npm)
  • 以下の npm パッケージが自動インストールされます:
    • live-server(ライブリロードサーバー)
    • qrcode-terminal(QRコード表示)

環境変数

  • PHONE_PREVIEW_PORT: サーバーのポート番号(デフォルト: 3000)
  • PHONE_PREVIEW_DIR: 公開するディレクトリ(デフォルト: カレントディレクトリ)

例

export PHONE_PREVIEW_PORT=8080
./start-preview.sh

注意事項

  • スマートフォンと同じネットワークにデスクトップが接続されている必要があります。
  • ファイアウォールで指定ポートがブロックされていないことを確認してください。
  • ローカル開発用途のみを想定しており、本番環境では使用しないでください。

関連スキル