product-marketing-context

product-marketing-context スキルの概要

product-marketing-context ができること

product-marketing-context スキルは、.agents/product-marketing-context.md に共通のプロダクトマーケティング用ソースファイルを作成・維持するためのスキルです。役割はシンプルですが実務的な価値があります。プロダクト概要、対象読者、ポジショニング、想定される反論、根拠となる証拠、メッセージングの基本要素を一度まとめておくことで、他のマーケティング作業が毎回同じ前提確認から始めずに、その内容を再利用できるようにします。

このスキルが向いている人

このスキルは、リポジトリやクライアント案件の中で、AI支援のマーケティング作業を繰り返し安定して回したい創業者、プロダクトマーケター、グロース責任者、代理店に特に向いています。ポジショニング設計、ICP整理、ランディングページの草案作成、キャンペーン企画、営業支援コンテンツなど、複数のメッセージング業務で一貫性を高めたい場合に特に有効です。

このスキルが本当に解決する仕事

多くのチームに必要なのは「コピーをもっと増やすこと」ではありません。何かを書かせる前に、モデルが参照できる安定したコンテキスト層です。product-marketing-context skill は、その土台づくりのために設計されています。まず再利用可能なマーケティング文脈ドキュメントを作り、その上に他のスキルを積み上げられるようにします。

なぜ汎用プロンプトより優れているのか

通常のプロンプトでもポジショニングを依頼することはできますが、多くはその場限りの回答になりがちです。product-marketing-context は、次のような運用前提で組み立てられています。

• まず既存のコンテキストファイルがあるか確認する
• 変わった箇所だけを更新する
• コードベースからの自動ドラフト、またはゼロからの対話形式セットアップを選べる
• 他のスキルが参照しやすい決まったファイルパスに保存する

そのため、単なる「メッセージングを手伝って」よりも、実務フローに組み込みやすいのが強みです。

向いているケースと向いていないケース

向いているケース:

• まだメッセージングの土台がない新規プロダクト
• 複数のAIマーケティングスキルを使う予定のあるリポジトリ
• ローンチ後、価格改定後、対象顧客の変化後にポジショニングを見直すチーム

向いていないケース:

• 永続化されたコンテキストが不要な単発のコピー作業
• 確認できるリポジトリやプロダクト資料がほとんどないプロダクト
• このスキル単体に深い市場調査まで期待しているチーム

product-marketing-context スキルの使い方

インストール時の前提とファイルの保存場所

環境が Skills のインストールに対応しているなら、親リポジトリを追加し、そこから product-marketing-context スキルを使用します。このスキルの中心となる出力先ファイルは次のとおりです。

/.agents/product-marketing-context.md

旧構成向けとして .claude/product-marketing-context.md も確認し、必要に応じてその内容を移行する支援もできます。

まず既存のコンテキストファイルを確認する

新規作成に入る前に、意図されたワークフローでは次のファイルを確認します。

• .agents/product-marketing-context.md
• .claude/product-marketing-context.md

すでにコンテキストファイルがある場合、正しい進め方は「全部書き直すこと」ではありません。まず内容を読み、何がすでに整理されているかを要約し、そのうえでユーザーの変更に関係するセクションだけを更新します。

product-marketing-context で適切なセットアップ経路を選ぶ

リポジトリ上では、実務的に次の2つの始め方が示されています。

1. コードベースから自動ドラフトを作る
   README.md、ランディングページの文言、ドキュメント、package.json、アプリ内のプロダクトコピーなど、リポジトリに使えるシグナルがある場合におすすめです。

2. ゼロから始める
   リポジトリの情報が薄い場合、コードよりも社内資料や非公開資料のほうが重要な場合、あるいはプロダクト定義自体がまだ固まり切っていない場合はこちらが適しています。

これは product-marketing-context guide の中でも特に重要な導入ポイントです。手元の証拠の質に合った経路を選ぶほど、結果が安定します。

product-marketing-context に必要な入力

使える出力にするには、少なくとも次の情報を渡してください。

• そのプロダクトが何であるか
• 誰向けか
• 解決する主な課題は何か
• 代替手段と比べて何が違うか
• 現時点の根拠や制約
• 今回が初稿なのか、既存内容の更新なのか

あると有用な追加情報:

• 価格帯やプラン変更
• 新しいペルソナ
• 受注・失注の傾向
• 商談やレビューに出てくる顧客の言い回し
• ブランドボイスの好み
• 営業現場でよく出る反論
• ローンチや四半期の目標

このスキルが構築しようとしているセクション

リポジトリ内の eval とワークフローを見ると、product-marketing-context usage では概ね次のようなセクションが対象になります。

• Product Overview
• Target Audience
• Personas
• Problems You Solve
• Competitive Landscape
• Differentiation
• Objections
• Switching Dynamics
• Customer Language
• Brand Voice
• Proof Points
• Goals

この構成が重要なのは、単なるポジショニング文ではなく、長く使い回せるコンテキストファイルを作ることが目的だからです。

ラフな依頼を強いプロンプトに変える

弱い例:

Help me with product marketing.

よりよい例:

Use the product-marketing-context skill. Check whether .agents/product-marketing-context.md already exists. If not, auto-draft a V1 from the repo and website copy. Capture product overview, ICP, personas, key pain points, differentiation, objections, proof points, customer language, and brand voice. Flag assumptions clearly so I can review them.

更新用途でさらによい例:

Use the product-marketing-context skill to update our existing context. We added an enterprise tier and now sell to VP of Engineering in addition to Product Managers. Read .agents/product-marketing-context.md, tell me which sections need revision, then update only those sections and preserve everything still valid.

推測を減らす実践的な product-marketing-context ワークフロー

実務では、次の順番で進めると安定します。

1. 既存のコンテキストファイルがあるか確認する。
2. 自動ドラフトにするか、対話形式で進めるかを決める。
3. セクションごとにコンテキストファイルを作成または更新する。
4. 仮定と証拠不足の箇所を明示する。
5. ユーザーに確認して修正を反映する。
6. .agents/product-marketing-context.md に保存する。
7. 後続のマーケティング作業でそのファイルを再利用する。

これが、プロジェクト早期に product-marketing-context install を行う大きな理由です。後工程で毎回セットアップし直す手間を減らせます。

最初に読むべきリポジトリ内ファイル

素早く評価したいなら、まず次のファイルを確認してください。

• skills/product-marketing-context/SKILL.md
• skills/product-marketing-context/evals/evals.json

SKILL.md には運用フローがまとまっています。evals/evals.json は、プロダクト変更後の更新例も含めて、現実的なプロンプトの中で「正しい使い方」がどう見えるかを把握するのに役立ちます。

出力品質を大きく左右するもの

最良の出力は、理想論ではなく証拠から生まれます。より強いコンテキスト文書にしたいなら、次のような素材を product-marketing-context に渡してください。

• ホームページやランディングページの文言
• プロダクトドキュメントやオンボーディング文言
• デモ録画やデモ会話のメモ
• 価格表やプラン説明
• 顧客インタビューの引用
• 実際に使っている競合比較
• 営業通話で出る反論
• 既存のブランドガイドライン

これらがない場合でもドラフト自体は作れますが、より一般論寄りの仮定が増えやすくなります。

product-marketing-context の初稿に期待すべきこと

product-marketing-context で作る V1 は、最終版ではなく作業用ドキュメントとして扱うのが適切です。役に立つ初稿は、次の条件を満たします。

• 確認済みの事実と、推定に基づくポジショニングを分けている
• 根拠不足や対象顧客の曖昧さを表に出している
• 後続のAIマーケティング作業で一貫性を保てるだけの構造を持っている

戦略メッセージとして磨き込んだ状態を求めるなら、初回ファイル作成後に少なくとも1回はレビューを挟む前提で考えるべきです。

product-marketing-context スキル FAQ

product-marketing-context は初心者にも向いていますか？

はい。ワークフローが明確なので初心者にも扱いやすいです。既存ファイルを確認し、自動ドラフトかガイド付きセットアップかを選び、指定されたセクションを埋めていけば進められます。正式なPMMフレームワークに詳しくなくても、実用的な初版は作れます。

通常のプロンプトではなく product-marketing-context を使うべきタイミングは？

複数の作業にまたがって再利用できるコンテキストが欲しいときです。ランディングページの見出しを1本だけ作りたいなら通常のプロンプトでも十分かもしれません。一方で、多数のアウトプットで一貫したメッセージを保ちたいなら、product-marketing-context for Product Marketing のほうが土台として適しています。

既存のコンテキストを作り直さずに更新できますか？

はい。そこが中核機能のひとつです。このスキルは既存の .agents/product-marketing-context.md を読み、すでに入っている内容を要約したうえで、新しい情報の影響を受けるセクションだけを更新するように設計されています。

市場調査までやってくれますか？

そこまでは期待しないほうがよいです。リポジトリやプロダクト資料から多くを推測できますが、顧客調査の代替にはなりません。証拠が弱ければ、構造的には役立つ出力でも、戦略面ではやや薄くなります。

リポジトリにマーケティング文言がほとんどない場合は？

ゼロから始める経路を選び、会話形式で質問に答えるのがおすすめです。顧客像、反論、購買文脈がほとんど見えない薄いコードベースに無理に自動ドラフトをかけるより、そのほうが良い結果になりやすいです。

product-marketing-context はこのリポジトリのスキル環境内でしか役立ちませんか？

他のマーケティング系スキルと組み合わせて .agents/product-marketing-context.md を参照させると最も効果を発揮しますが、ファイル自体は持ち運び可能です。スキル群全体を使わない環境でも、正本となる PMM ブリーフとして十分活用できます。

どんな場合にこのスキルは不向きですか？

次のような場合は見送って構いません。

• 単発で孤立したコピー出力だけが必要
• チームで共通コンテキストファイルを維持するつもりがない
• そもそも対象顧客や課題について基本的な問いにまだ答えられないほど、プロダクト定義が曖昧

product-marketing-context スキルを改善する方法

ゴールだけでなく証拠を渡す

product-marketing-context skill の品質を最も大きく引き上げるのは、より良い一次情報です。「ポジショニングを強くしたい」だけでは不十分です。次のような生素材を渡してください。

• ホームページの文言
• 顧客通話のメモ
• 営業でよく出る反論
• 顧客が乗り換える理由
• 機能と便益のつながりを示す説明
• 数字付きの proof points

そうすることで、モデルは主張を勝手に作るのではなく、与えられた根拠に基づいて整理できます。

何が変わったかを明確に伝える

更新時に、実際には2点しか変わっていないのに全体のリフレッシュを依頼しないでください。何が新しいのかを具体的に伝えます。

• 新しい価格帯やプラン
• 拡張された ICP
• カテゴリ名の変更
• より強いエンタープライズ志向
• 新たな競合圧力

これにより、まだ正しいメッセージを崩さずに、必要なセクションだけを更新しやすくなります。

仮定にラベルを付けるよう依頼する

よくある失敗のひとつが、推測が推測として見えないことです。出力品質を上げるには、モデルに次の区分を明示させてください。

• confirmed facts
• likely inferences
• missing inputs
• questions for review

このひと手間で、初稿のレビューと修正がかなり楽になります。

最終品質を上げるにはセクション単位でレビューする

最後に文書全体をまとめて見るだけでは不十分です。早い段階で重点的に検証すべきなのは次のセクションです。

• Target Audience
• Problems You Solve
• Differentiation
• Objections
• Proof Points

ここがズレていると、その後このファイルをもとに作るメッセージ全体もズレていきます。

顧客の言葉の取り込みを強化する

よく弱くなりがちなポイントは、表現が抽象的で一般的になることです。実運用で product-marketing-context guide の精度を高めるには、顧客が実際に使っている言い回しを入力してください。たとえば次のような場面です。

• インタビュー
• サポートチケット
• レビューサイト
• 営業通話
• オンボーディング時のフィードバック

実際の顧客言語が入ると、後続のコピーの関連性と説得力が大きく向上します。

よくある失敗パターンに注意する

典型的な問題には次のようなものがあります。

• ポジショニングに見せかけた機能一覧
• 広すぎる ICP
• 曖昧な「競合」に対する弱い差別化
• 例示のない理想論的なブランドボイス
• 証拠ではなく主張だけになっている proof points

こうした兆候が見えたら、書き直しを頼む前に、まず元の入力素材を見直すほうが効果的です。

的を絞った追加入力で反復する

初稿のあとには、全面的な書き直しではなく、焦点を絞ったプロンプトを使うのが有効です。たとえば:

• “Narrow the ICP to the most likely first buyer.”
• “Rewrite objections based on enterprise procurement concerns.”
• “Separate direct competitors from status-quo alternatives.”
• “Turn proof points into evidence-backed bullets only.”

このようなピンポイントの反復のほうが、文書の改善はずっと速く進みます。

product-marketing-context を生きたファイルとして維持する

product-marketing-context の最も良い使い方は、一度作って終わりではなく継続的に保守することです。プロダクト、対象顧客、価格、カテゴリ、営業プロセスが変わったタイミングで見直してください。そうすることで、下流のマーケティング作業が古い前提ではなく、現在の実態に沿って揃い続けます。