product-marketing-context

概要

このスキルでできること

product-marketing-context スキルは、プロジェクト用のプロダクトマーケティングコンテキストを、1つの再利用しやすいドキュメントとして作成・維持するためのスキルです。

タスクごとに毎回、プロダクト概要やターゲット、ポジショニングを説明し直す代わりに、このスキルが構造化された質問に沿ってヒアリングし、その結果を次のファイルに保存します。

• .agents/product-marketing-context.md

他の互換性のあるマーケティングスキルやエージェントはこのファイルを読み込むことで、あなたのプロダクトを理解し、一貫したメッセージでコンテンツ、キャンペーン、ローンチ資料などを生成できるようになります。

想定ユーザー

product-marketing-context は、次のような方に向いています。

• プロダクトのストーリーを初めて言語化する ファウンダー や プロダクトオーナー
• キャンペーン間でメッセージをブレさせたくない プロダクトマーケター や マーケティングマネージャー
• 共通のコンテキストファイルを共有するマーケティングスキル／エージェント群を実装する デベロッパー

特に、以下のような業務で役立ちます。

• 継続的な コンテンツマーケティング（ブログ、メール、広告、ランディングページなど）
• プロダクトローンチ やプラン／ティアのアップデート
• ポジショニングや ICP / ペルソナ の見直し・精緻化

解決する課題

product-marketing-context スキルは、次のようなよくある課題を解消するために設計されています。

• 複数の会話やタスクで、同じプロダクト説明やターゲット情報を何度も繰り返している
• スキルやエージェントごとにメッセージが微妙に異なり、一貫性がない
• プロダクトマーケティングのメモが複数のファイルに散在している、またはそもそもまとまっていない
• ポジショニングドキュメントがメンテナンスしづらく、更新されないまま放置されている

これらを .agents/product-marketing-context.md に集約することで、次の内容をカバーする「生きたドキュメント」を持てるようになります。

• プロダクト概要とバリュープロポジション
• ターゲットオーディエンスと ICP
• 購買プロセスに関わるペルソナとロール
• 解決する課題と jobs-to-be-done
• 競合環境と差別化要因
• 反論や乗り換えのハードル、信頼獲得の根拠
• 顧客の言葉遣い、ブランドボイス、マーケティング目標

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

product-marketing-context を使うとよいケース

• 新規プロジェクト を始める際に、他のマーケティング系スキルを使う前の土台をしっかり固めたい
• 価格、プラン構成、ターゲットが変わった（例: エンタープライズティアや新しいバイヤーロールを追加した）
• 共有コンテキストが前提の AI 駆動マーケティングワークフローを構築している

向いていない可能性があるケース

• 単発のコピーを 1 つ書ければよく、その後コンテキストを再利用する予定がない
• プロダクトがアイデア段階に近く、まだ何も固まっていない（その場合はいったん基本的な仮説をメモしてから、このスキルを実行するとスムーズです）

複数のマーケティングタスクを行う予定があるなら、最初に product-marketing-context を導入しておくことで、早い段階から効率化のメリットを得やすくなります。

使い方

インストール

product-marketing-context スキルを環境に追加するには、次を実行します。

npx skills add https://github.com/coreyhaines31/marketingskills --skill product-marketing-context
``

このコマンドで、`coreyhaines31/marketingskills` リポジトリから `product-marketing-context` スキルが取得され、同じソースからインストールした他のスキルと並んで利用できるようになります。

インストール後は、エディタでスキルのファイルを開き、挙動を確認したり、自分のワークフローに合わせて調整したりできます。

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

### 基本ワークフロー
product-marketing-context スキルは、「コンテキストファイルが既にあるかどうか」に応じて 2 パターンのワークフローをとります。

#### 1. 既存のコンテキストの有無を確認
スキルが呼び出されると、まず既存のコンテキストドキュメントを探します。

- 基本の場所: `.agents/product-marketing-context.md`
- レガシーな場所: `.claude/product-marketing-context.md`（旧来のセットアップ向け）

古いファイルが `.claude/` のみに存在する場合は、`.agents/` に移動またはアップグレードするよう促す設計になっており、セットアップを新しい構成に揃えられます。

#### 2. コンテキストファイルが既にある場合
`.agents/product-marketing-context.md` が存在する場合、スキルは次のように動作します。

1. 現在の内容を読み取り、要約する
2. どのセクションを更新したいか（例: Target Audience、Personas、Differentiation など）を確認する
3. 選択したセクションのみを対話形式で更新するため、全セクションを最初からやり直す必要はない

これにより、次のような「段階的なアップデート」が簡単になります。

- ターゲットオーディエンスを拡張する（例: VP of Engineering を追加する）
- 新しいプランやティアを追加する（例: enterprise plan）
- Proof points やロゴ、ケーススタディを更新する

#### 3. コンテキストファイルがまだない場合
コンテキストファイルが見つからない場合、スキルは次の 2 つのパスを提案します。

1. **Auto-draft from codebase（推奨）**
   - リポジトリ内の情報（例: `README`、ランディングページ、マーケティングコピー、`package.json` など）を自動で参照します。
   - 見つかった情報をもとに、プロダクトマーケティングコンテキストの初版（V1）をドラフトします。
   - そのドラフトをあなたがレビューし、修正・補足して完成させます。

2. **ゼロから作成する**
   - スキルが各セクションを 1 つずつ会話形式で案内します。
   - プロダクト、ターゲット、ポジショニングなどについて、ピンポイントな質問に答えていきます。

どちらのパスを選んだ場合でも、プロセス完了時に最終的なドキュメントは次の場所に保存されます。

- `.agents/product-marketing-context.md`

### コンテキストファイルに含まれるセクション
product-marketing-context が生成するコンテキストファイルは、実務で再利用しやすいセクション構成になっています。同梱の evals によると、状況に応じて少なくとも以下の領域をカバーすることが期待されています。

- **Product Overview** – 何を売っていて、何ができ、誰のためのものか
- **Target Audience** – ICP、ロール、業種、企業規模など
- **Personas** – Product Manager、VP、ファウンダー、バイヤーなどの主要ステークホルダー
- **Problems You Solve** – ペインポイント、jobs-to-be-done、ユースケース
- **Competitive Landscape** – 競合となるプロダクトや、買い手がどう代替案を見ているか
- **Differentiation** – プロダクトを意味のある形で差別化しているポイント
- **Objections** – 見込み顧客が躊躇したり、No と言ったりする典型的な理由
- **Switching Dynamics** – あなたのプロダクトに乗り換えるために起こるべき変化・要件
- **Customer Language** – 実際の顧客が使うフレーズや引用、語彙
- **Brand Voice** – チャネルを横断して、どのようなトーン・スタイルで伝えたいか
- **Proof Points** – テスティモニアル、指標、ソーシャルプルーフ、ケーススタディ
- **Goals** – マーケティングおよび go-to-market で、成功をどう定義するか

すべてのプロダクトで全セクションを完全に埋める必要はありませんが、このスキルは該当しうるセクションを網羅し、不足している情報があれば丁寧に質問するよう設計されています。

### ワークフローでのコンテキストの活用方法
一度 `.agents/product-marketing-context.md` が作成されれば、次のように活用できます。

- 他の **マーケティング関連スキル** を実行する際に参照し、プロダクト理解を共有する
- リポジトリでバージョン管理し、ポジショニングの変遷を追跡する
- 新しく参加したメンバーや外部パートナーへの「社内ソース・オブ・トゥルース」として使う

ファイルのパスが固定されているため、次のような用途でも扱いやすくなります。

- `marketingskills` コレクション内の他のエージェント
- 自作のツールやスクリプト

…がこのファイルを読み込み、一貫したプロダクトマーケティングの土台として利用できます。

### 確認しておきたいファイルとディレクトリ
挙動の理解やカスタマイズを進める際は、まず次のファイルから確認するとよいでしょう。

- `SKILL.md` – スキルの基本定義、概要、ワークフローの詳細
- `evals/evals.json` – 代表的なプロンプトと期待されるふるまいの例。実際の利用シナリオで、どのように応答するかを確認するのに役立ちます。

そのうえで、スキルの呼び出し方や他スキルとのチェーンの仕方を、自分のリポジトリ構成や自動化ツールに合わせて調整できます。

## FAQ

### product-marketing-context を一言でいうと何ですか？
product-marketing-context スキルは、`.agents/product-marketing-context.md` に保存される構造化されたプロダクトマーケティングドキュメントを、ガイド付きで作成するアシスタントです。プロダクト、ターゲット、ポジショニング、主要メッセージを整理し、他のスキルやエージェントが再利用できるようにします。

### product-marketing-context のインストール方法は？
`coreyhaines31/marketingskills` リポジトリから次のコマンドでインストールできます。

```bash
npx skills add https://github.com/coreyhaines31/marketingskills --skill product-marketing-context

インストール後は、product-marketing-context ディレクトリ内の SKILL.md を開くと、具体的なワークフローを確認できます。

コンテキストドキュメントはどこに保存されますか？

デフォルトでは、次の場所にプロダクトマーケティングコンテキストを作成・維持します。

• .agents/product-marketing-context.md

また、.claude/product-marketing-context.md にある旧セットアップも検出でき、.agents/ への移行を提案します。

すでに product-marketing-context ファイルがある場合はどうなりますか？

.agents/product-marketing-context.md がすでに存在する場合、スキルは次のように動作します。

1. 内容を読み取り、要約する
2. どのセクションを変更したいかを確認する
3. そのセクションに必要な情報だけを新たにヒアリングする

これにより、既に記録済みの情報について、同じ質問に繰り返し答える必要がなくなります。

プロダクトの変更に合わせて、コンテキストを更新できますか？

はい。段階的なアップデートを前提に設計されています。例えば次のような変更があったときに便利です。

• 新しい enterprise tier を追加した
• ターゲットオーディエンスを新しいロールまで拡大した（例: VP of Engineering を追加）
• 差別化ポイントや proof points を見直した

このような場合はスキルを呼び出せば、.agents/product-marketing-context.md の関連セクションだけを更新する手順を案内してくれます。

このスキルは、コードベースから自動でコンテンツをドラフトしてくれますか？

可能です。コンテキストファイルがまだ存在しない場合、product-marketing-context は auto-draft from codebase オプションを提供します。このモードでは、リポジトリ内の README、マーケティングコピー、package メタデータなど、利用可能な資料を読み取り、それをもとに初版のドラフトを生成します。その後、あなたが内容をブラッシュアップします。

product-marketing-context は他のマーケティングスキルとどう連携しますか？

セットアップ内の他のマーケティング系スキルは、.agents/product-marketing-context.md を読み込むことで、次のような情報を共有できます。

• プロダクトと ICP の理解
• ブランドボイスやメッセージングの指針
• ポジショニングや目標との整合性

新しいプロジェクトでは、まず product-marketing-context を 最初に 実行して共通コンテキストファイルを整備し、その後メール、ランディングページ、ローンチアナウンスメントなどの制作時にこのファイルを参照する、という使い方が一般的です。

開発者にとっても有用ですか？

はい。有用です。複数スキルを組み合わせたワークフローを構築するデベロッパーは、.agents/product-marketing-context.md を次のような「単一のソース・オブ・トゥルース」として扱えます。

• リポジトリ内に存在し
• プログラムからパース・ロードしやすく
• すべてのマーケティング関連スキルの前提を揃えられる

特に、大規模な自動化セットアップで複数のエージェントが同じプロダクト・ターゲット情報を必要とする場合に効果的です。

スキルの理解やカスタマイズのために、どのファイルを見ればよいですか？

まずは次のファイルから確認するのがおすすめです。

• SKILL.md – product-marketing-context の目的とワークフローの説明
• evals/evals.json – 代表的なプロンプトと期待される出力例。実際の利用シーンでのスキルのふるまいを把握するのに役立ちます。

そのうえで、スキルの呼び出し方法や他スキルとの連携方法を、自分のリポジトリ構成やマーケティングプロセスに合わせて調整してください。