はじめに
ListenHub Skills をインストールして、5 分以内に最初のコンテンツを生成します。
このガイドでは、インストール、設定、そして最初のコンテンツ生成までを順に説明します。
前提条件
- Agent Skills に対応した AI コーディングツール — Claude Code、Cursor、Windsurf、OpenCode など
- ListenHub API キー — まず 無料アカウントを作成 し、続いて API キーを取得 する
- curl と jq — 通常はプリインストール済み。入っていない場合は AI が自動でインストールします
インストール
npx skills add marswaveai/skillsbunx add-skill marswaveai/skillsインストールが完了すると、Skill ファイルが自動的にプロジェクトディレクトリに追加されます。
更新方法と AI Agent による自動化の手順は Skills の更新 を参照してください。
API キーの設定
初回利用時、AI は API キーが未設定であることを検出し、設定手順を案内します：
- ListenHub API キー設定ページ を開く（ログインが必要）
- 新しい API キーを作成するか、既存のキーをコピーする（形式：
lh_sk_...） - AI に求められたらキーを貼り付ける
キーは自動的に保存されます。この作業は一度だけで済みます。
環境変数として手動でキーを設定することもできます：
export LISTENHUB_API_KEY="lh_sk_..."この行を ~/.zshrc（macOS）または ~/.bashrc（Linux）に追加し、source ~/.zshrc を実行してください。
最初の生成
次のいずれかのプロンプトを試して、正しく動作することを確認してください：
| 例 | 実行される内容 |
|---|---|
Make a podcast about AI trends | ポッドキャストのエピソードを生成します |
Read this aloud: Hello world | テキストを音声に変換します |
Generate an image: a cat in space | AI 生成の画像を作成します |
Transcribe this file: meeting.m4a | 音声をテキストに文字起こしします（オフライン） |
ボイスの選択、台本の作成、生成は AI が自動で処理します。完了すると、聴く・見る・ダウンロードするためのリンクが届きます。
結果の取得
生成が完了したら：
- ポッドキャストと音声 — デフォルトでは AI が会話内にリンクを表示します。ローカルに保存するには、設定時に出力モードを
downloadまたはbothにするか、「download audio」と伝えてください - 解説動画 — AI が会話内にリンクを提示します。ダウンロードはリクエストすれば可能です
- 画像 — デフォルトでは会話内に表示されます。出力モードが
downloadの場合は.listenhub/image-gen/に保存されます - 文字起こし — listenhub.ai のエピソード詳細ページで確認できます
プロンプト例
| 目的 | プロンプト |
|---|---|
| 中国語のポッドキャスト、quick モード | Make a podcast about XXX, in Chinese |
| 英語のポッドキャスト、deep モード | Make a podcast about XXX, in English, mode: deep |
| 解説動画 | Make an explainer video about XXX |
| テキスト読み上げ | Read this aloud: [your text] |
| 画像生成 | Generate an image: XXX, 16:9, 2K |
デフォルトの動作
一部のパラメータを指定しない場合、AI は妥当なデフォルト値を使用します：
| パラメータ | デフォルト |
|---|---|
| 言語 | 入力内容から自動判別 |
| ポッドキャストモード | quick + 1 人（トピックのみを指定した場合） |
| ボイス | 判別された言語で最初に利用できるボイス |
| 音声モード | FlowSpeech direct（テキストをそのまま読み上げ） |
次のステップ
さらに多くの例と図解付きの手順は、Way to AGI ワークショップチュートリアル（Feishu） を参照してください。