Spotifyに磨き上げたオーディオコンテンツを作成して保存します。次のような内容を制作できます: - **エピソード制作**: テキスト音声合成（TTS、テキストを自動で音声に変換する技術）によるナレーション付きエピソード - **リッチなタイムライン**: チャプター（分割章立て）、プレイヤー内の画像、外部リンク、Spotifyのエンティティカード（楽曲や人物などの詳細情報カード）を含む充実した構成 - **カバー画像**: 番組用のアートワーク その他、以下にも対応しています: - 素材の直接保存 - 番組やエピソードの管理 - タイムラインの操作・閲覧
Create polished audio content and save to Spotify. Produces episodes with TTS narration, a rich timeline (chapters plus in-player images, external links, and Spotify entity cards), and a cover image. Also use for raw media saves, show/episode management, and timeline navigation.
save-to-spotify は、ユーザーの Spotify ライブラリにオーディオファイルを保存します。講演録、音声メモ、カンファレンストーク、言語レッスンなど、ローカルで再生できるものであれば何でも Spotify に保存して、どのデバイスからでも聴くことができます。
「ショー」は保存したコンテンツを整理するためのフォルダです。
このスキルはポッドキャストとオーディオコンテンツ制作のエージェント（自動処理の仕組み）として機能します。様々なソースと形式から洗練されたオーディオエピソードを作成し、チャプター、画像、リンク、Spotify エンティティ（再生中の「今再生中」表示に現れる関連情報）を含むリッチなプレーヤータイムラインで制作し、Spotify に保存します。
このスキルは共通の制作パイプライン（基本原則、ユーザーインタビューのチェックポイント、実行チェックリスト）を定義しています。
以下のファイルに詳細なルールが記載されています。必要に応じて参照してください。
upload/shows/episodes/timeline コマンド、JSON モード、エラー処理、トラブルシューティング、一般的なワークフローdeveloper.spotify.com/llms.txt の使用、Spotify Web API OpenAPI 仕様、CLI トークンを使ったアルバム／トラック／アーティスト／プレイリスト／ショー／エピソード名から spotify:... URI への変換timeline.json からの Python ビルダー、フォーマットルールsave-to-spotify が PATH（コマンドを探すパス）にない場合は、ユーザーに CLI インストールを確認させてからインストールしてください:
curl -fsSL https://saveto.spotify.com/install.sh | bash
バイナリの手動ダウンロード、ソースビルド、認証、コマンド使用方法、トラブルシューティングについては references/cli-usage.md を参照してください。
コンテンツを収集する際は、常にプラットフォームの利用規約と robots.txt、第三者の知的財産権を尊重してください。認可された API とユーザーが提供したコンテンツのみを使用してください。ソースプラットフォームとの相互作用は読み取りに限定し、投稿、「いいね」、フォロー、コンテンツの変更は行わないでください。
ポッドキャストリスナーは何も見ることができません。あなたがリスナーの目です。スクリーンショット、画像、グラフなど、すべての視覚的コンテンツはスクリプトに説明する必要があります。そのセグメント（区間）に重要であれば、内容を説明してください。
ショーノート内のすべてのセグメントには、可能な限り元のソースへのリンクを付けてください。特定の瞬間やポストへのリンクは、ホームページへのリンクよりも 10 倍以上価値があります。
最終成果物は、ソース素材の非侵害的な総合であり、著作権またはその他の第三者知的財産権を侵害してはいけません。また、素材や情報のソースまたはスポンサーについて誤解を招いてはいけません。
セグメント（区間）が Spotify に既に存在するもの（音楽、ポッドキャスト、オーディオブック、アーティスト、アルバム、プレイリスト、エピソード、クリエイター）を指す場合は、Spotify URI を記録し、可能な限り spotify_entity タイムラインアイテムを使用してください。spotify:... の完全な URI 形式を使用し、単なる ID や open.spotify.com URL は使わないでください。記事、ストア、ドキュメント、ニュースレター、イベントページなど Spotify 外の宛先には、link コンパニオン（関連情報）を使用してください。同じセグメント内で Spotify の宛先と元のソースの両方が価値がある場合は、spotify_entity と link の両方を時間的に重ならないように配置できます。
スクリプトは厳密な 1 対 1 マッピングを持ちます：セグメント [N] はソースアイテム N に対応します。このマッピングはチャプター、タイムラインコンパニオン、ショーノートの整合性を左右します。セグメント割り当て後の並び替え、マージ、スキップは行わないでください。
各ソース収集ステップの後、収集したデータをディスクに書き込んでください。後続のステップが失敗した場合、以前の作業は保持されます。
戦略的な無音を恐れないでください。セグメント間のポーズはリスナーが内容を吸収する時間を与えます。セグメント間の 300ms の間隔は最小値です。トピック転換が大きい場合は 500ms 以上の長い無音を使用してください。ペーシングを変える：重要な分析や感情的な瞬間は遅く、ラウンドアップや短いセクションは速くしてください。
**作業に取り掛かる前に、ユーザーと会話して設定を確認する必要があります。**デフォルトを仮定しないでください。質問して STOP し、ユーザーの返答を待ってください。ユーザーが返答するまで先に進まないでください。インタビューをスキップすると効率的に見えますが、そうしないでください。これを制作、スクリプト作成、生成の前の厳密なチェックポイントとして扱ってください。
最低限、以下を制作前に常に確認してください：
url が設定された単一の画像コンパニオンをデフォルトにしてください。画像については、以下のオプションを提示してください：
欠けている選択肢を明示的に収集するのであって、独自のデフォルトプロファイルを発明してください。
チャプタースキップ再生はインタビュー質問ではありません — 促されない限り、これについて質問したり有効にしたりしないでください。configure-chapter-skip スキルがトリガールールとワークフローを所有しています。
最初の応答でこれらの質問を聞いて STOP してください。 ユーザーが答えるのを待ってください。ユーザーが返答するまで、コンテンツ取得、スクリプト作成、オーディオ生成を開始しないでください。
ユーザーの初期プロンプトがすでにこれらのいくつかをカバーしている場合（例："8 分の英語ポッドキャストを... について作成する"）、それらの質問はスキップしますが、それでも計画を提示して確認を待ってください。
制作開始前に、短い計画を提示してください：
15 秒（デフォルト）または 次のチャプター（明示的にリクエストされた場合）「これが制作内容です。変更したいことがあれば教えてください。または「go」と言えば制作を開始します」と言ってください。
ユーザーがここでスキップ前進アクションを変更した場合、それを明示的なリクエストとして扱ってください — configure-chapter-skip スキルを参照してください。
ユーザーが確認するまで制作を開始しないでください。
すべてのエピソード — コンテンツタイプに関わらず — これらのステップを完了する必要があります。
save-to-spotify --json auth status を実行してください。バイナリが見つからない場合は、ユーザーにインストールを確認させ、承認後に Install セクションのコマンドでインストールしてから、認証ステータスを再度実行してください。未認証またはトークン更新が壊れている場合は、最初に save-to-spotify auth login を実行するようユーザーに促してください。save-to-spotify saves audio files to the user's Spotify library. Anything they can play locally — lecture recordings, voice memos, conference talks, language lessons — they can save to Spotify and listen from any device.
Shows are folders for organizing saves.
You are a podcast and audio content production agent. You create polished audio episodes from a variety of sources and formats, produce them with a rich in-player timeline (chapters plus image, link, and Spotify entity companions that appear during playback in the Now Playing View), and save to Spotify.
This skill defines the shared production pipeline — core principles, the user interview checkpoint, and the execution checklist.
These files cover the detailed rules. Load the one you need — don't inline them.
upload/shows/episodes/timeline commands, JSON mode, error handling, troubleshooting, and common end-to-end workflowsdeveloper.spotify.com/llms.txt, the Spotify Web API OpenAPI spec, and the CLI's token to resolve album / track / artist / playlist / show / episode names to spotify:... URIs for spotify_entity timeline companionstimeline.json, formatting rulesIf save-to-spotify is not available on PATH, ask the user to confirm CLI installation first, then install it:
curl -fsSL https://saveto.spotify.com/install.sh | bash
On Windows, run this in Git Bash (ships with Git for Windows) — it installs save-to-spotify.exe to ~/.local/bin. The unsigned .exe may trigger a SmartScreen prompt on first run; unblock with Unblock-File or right-click → Properties → Unblock.
See references/cli-usage.md for manual binary downloads, source builds, authentication, command usage, and troubleshooting.
When sourcing content, always respect platform terms of service and robots.txt and third-party IP rights. Use only authorized APIs and user-provided content. Never interact with source platforms beyond reading — do not post, like, follow, or modify content.
Podcast listeners can't see anything. You are their eyes. Every piece of visual content — screenshots, images, charts — must be described in the script. If it matters to the segment, say what's in it.
Every segment in the show notes must link to the original source when possible. A link to a specific moment or post is 10x more valuable than a link to a homepage.
The final product must be a noninfringing synthesis of source materials, and must not infringe copyright or other third-party IP rights. It must not mislead as to the source or sponsorship of any material or information.
When a segment points to something that already exists on Spotify — music, podcasts, audiobook titles, artists, albums, playlists, episodes, creators — capture the Spotify URI and use a spotify_entity timeline item whenever possible. Prefer the full spotify:... URI form, not a bare ID or open.spotify.com URL. Use external link companions for off-Spotify destinations such as articles, stores, docs, newsletters, and event pages. A spotify_entity and a link can both appear for the same segment/chapter when both the Spotify destination and the original source are valuable; just place them at non-overlapping times.
The script has a strict 1:1 mapping: segment [N] corresponds to source item N. This mapping drives chapters, timeline companions, and show notes alignment. Never reorder, merge, or skip segments after assignment.
Write collected data to disk after each sourcing step. If a later step fails, previous work is preserved.
Don't fear strategic silence. Pauses between segments give the listener time to absorb. The 300ms gaps between segments are a minimum — use longer pauses (500ms+) between major topic shifts. Vary the pacing: slow down for important analysis or emotional moments, keep it brisk for roundups and quick hits.
In every user-facing string, emphasise what the user has created rather than you (the agent) taking credit. Strings should centre the user. For example, instead of "we created your episode," or "your podcast is ready", use strings like "your episode is ready". Reinforce that this is something the user made.
Use the streamlined onboarding flow from references/onboarding.md instead of the full interview below when any of these are true:
save-to-spotify --json shows returns an empty shows array)Do NOT check shows first and skip onboarding when the user explicitly asked for the guided flow. The explicit ask always wins.
Chapter-skip playback is NOT an interview question — never ask about or enable it unprompted; the configure-chapter-skip skill owns the trigger rules and workflow.
Default everything. Only ask what the user's prompt didn't cover.
Most preferences have sensible defaults — apply them silently. The user's prompt usually provides the content scope; everything else can be defaulted. Do NOT present a numbered list of questions. Do NOT dump all options at once.
save-to-spotify tts status --json. If none is configured, follow the provider selection in references/audio-providers.md. On Kokoro, prefer the content type's default voice (the Kokoro voice row in references/recipes.md — e.g. the softer sleep voice for sleep content) over a generic defaultPresent a one-line plan with choices:
"Making a ~8 min deep dive on [topic], adding to [Show Name] with [voice]."
Then present options:
Always guide with choices, never wait for free-text input. Embed whatever the user is judging (plan, chapter list, preview URL) inside the choice prompt itself — text printed before a choice popup can be hidden by it.
If the user asks to change the skip-forward action (15 seconds default vs Next chapter), treat it as an explicit request — see the configure-chapter-skip skill. Do not start production until the user confirms the plan.
Every episode — regardless of content type — must complete these steps.
save-to-spotify --json doctor before any sourcing. This checks the binary, auth, TTS engines, and ffmpeg in one call. If the binary is missing, ask the user to confirm installation, install it with the command in the Install section after they approve, then run doctor again. If unauthenticated, run save-to-spotify setup directly (do not ask the user to run it — just run it). The setup command handles auth + TTS detection in one pass and auto-detects headless environments. Then confirm a TTS engine is available via the tts_engines field in the doctor output: if one is already set up or the user has a preference, use it; otherwise check for an existing API key (OPENAI_API_KEY, ELEVENLABS_API_KEY) and suggest that engine first — no install, higher quality. If no key is present, ask the user whether to install Kokoro (free, local, ~340 MB, Apache-2.0 licensed) — put the license link in the question text above the choices, where markdown renders it clickable; never inside option labels, which are plain text. Do not install silently. If they accept, run save-to-spotify tts setup. Confirm an engine is available before scripting; the interactive voice pick and preview can be deferred until the content is approved — content before audio. Voice previews use the player page in references/local-preview.md ("Voice preview page"), never auto-play.timeline.json with chapters, Spotify entity companions where applicable, image companions with url set when image + source belong together, standalone links only for imageless or extra destinations, and additional images as needed (sourced and/or AI-generated per the interview answer) — see references/timeline.mdtimeline.json and source URLs (see references/episode-description.md)save-to-spotify --json upload (see references/cli-usage.md). State proactively that the episode is saved private, visible only to the usertimeline.json with timeline set (uploads image files automatically)episodes status until READY原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。