product-marketing-context

Tổng quan

Kỹ năng này làm gì

Kỹ năng product-marketing-context giúp bạn tạo và duy trì một tài liệu bối cảnh marketing sản phẩm duy nhất, có thể tái sử dụng cho toàn bộ dự án.

Thay vì phải giải thích lại sản phẩm, đối tượng và định vị mỗi khi bắt đầu một tác vụ mới, kỹ năng này sẽ dẫn bạn qua một bộ câu hỏi có cấu trúc và lưu kết quả vào:

• .agents/product-marketing-context.md

Các kỹ năng và agent marketing tương thích khác sẽ đọc file này để hiểu về sản phẩm của bạn, từ đó tạo nội dung, chiến dịch và tài liệu launch thống nhất thông điệp.

Dành cho ai

Hãy dùng product-marketing-context nếu bạn là:

• Founder hoặc product owner đang xây dựng câu chuyện sản phẩm lần đầu
• Product marketer hoặc marketing manager muốn đảm bảo thông điệp nhất quán xuyên suốt các chiến dịch
• Developer đang thiết lập hệ thống các kỹ năng và agent marketing cùng dùng chung một file bối cảnh

Kỹ năng này đặc biệt hữu ích khi bạn làm việc với:

• Content marketing liên tục (blog, email, quảng cáo, landing page)
• Product launch và cập nhật tier
• Tối ưu định vị hoặc ICP / persona

Những vấn đề kỹ năng giải quyết

Kỹ năng product-marketing-context được thiết kế để xử lý những vấn đề lặp lại sau:

• Phải lặp lại mô tả sản phẩm và chi tiết đối tượng trong nhiều cuộc trao đổi khác nhau
• Thông điệp thiếu nhất quán giữa các agent hoặc kỹ năng khác nhau
• Ghi chú marketing sản phẩm bị thiếu, rời rạc, nằm rải rác ở nhiều file
• Tài liệu định vị khó duy trì, ít khi được cập nhật

Bằng cách tập trung tất cả vào .agents/product-marketing-context.md, bạn có một tài liệu sống bao quát:

• Tổng quan sản phẩm và value proposition
• Đối tượng mục tiêu và ICP
• Personas và vai trò tham gia vào quá trình mua hàng
• Những vấn đề bạn giải quyết và jobs-to-be-done
• Bối cảnh cạnh tranh và điểm khác biệt
• Objection, động lực chuyển đổi và các điểm chứng minh (proof points)
• Ngôn ngữ khách hàng, giọng thương hiệu và mục tiêu marketing

Khi nào phù hợp hoặc không phù hợp

Hãy dùng product-marketing-context khi:

• Bạn bắt đầu một dự án mới và muốn có nền tảng vững chắc trước khi dùng các kỹ năng marketing khác
• Bạn vừa thay đổi pricing, tier hoặc đối tượng (ví dụ thêm enterprise tier hoặc các vai trò người mua mới)
• Bạn đang thiết lập một workflow marketing dùng AI cần bối cảnh dùng chung

Có thể không phù hợp khi:

• Bạn chỉ cần viết một nội dung đơn lẻ và không có ý định tái sử dụng bối cảnh
• Sản phẩm của bạn ở giai đoạn quá sớm và bạn gần như chưa có bất kỳ rõ ràng nào (trong trường hợp đó nên phác thảo những điều cơ bản trước rồi mới chạy kỹ năng này)

Nếu bạn dự định làm hơn một tác vụ marketing, cài đặt product-marketing-context từ đầu thường sẽ mang lại lợi ích rất nhanh.

Cách sử dụng

Cài đặt

Để thêm kỹ năng product-marketing-context vào môi trường của bạn, chạy:

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

Lệnh này sẽ lấy kỹ năng `product-marketing-context` từ repository `coreyhaines31/marketingskills` và giúp nó sẵn sàng sử dụng cùng với các kỹ năng khác bạn cài từ nguồn này.

Sau khi cài đặt, bạn có thể mở trực tiếp các file của kỹ năng trong editor để xem cách hoạt động và điều chỉnh workflow theo nhu cầu:

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

### Quy trình cốt lõi
Kỹ năng product-marketing-context đi theo một quy trình rõ ràng với hai nhánh, tùy thuộc việc file bối cảnh đã tồn tại hay chưa.

#### 1. Kiểm tra bối cảnh hiện có
Khi được gọi, kỹ năng sẽ kiểm tra xem đã có tài liệu bối cảnh nào chưa:

- Vị trí chính: `.agents/product-marketing-context.md`
- Vị trí cũ: `.claude/product-marketing-context.md` (cho các setup trước đây)

Nếu chỉ tồn tại file cũ trong `.claude/`, kỹ năng sẽ đề xuất chuyển hoặc nâng cấp nó sang `.agents/` để cấu trúc của bạn nhất quán.

#### 2. Khi file bối cảnh đã tồn tại
Nếu `.agents/product-marketing-context.md` đã có sẵn, kỹ năng sẽ:

1. Đọc và tóm tắt nội dung hiện tại
2. Hỏi bạn muốn cập nhật những phần nào (ví dụ Target Audience, Personas hoặc Differentiation)
3. Chỉ dẫn bạn qua các phần đã chọn, nên bạn không phải lặp lại mọi thứ

Cách này giúp bạn dễ dàng cập nhật dần dần, chẳng hạn:

- Mở rộng đối tượng mục tiêu (ví dụ thêm VP of Engineering)
- Thêm một gói hoặc tier mới (ví dụ enterprise plan)
- Cập nhật proof points, logo hoặc case study

#### 3. Khi file bối cảnh chưa tồn tại
Nếu không tìm thấy file bối cảnh, kỹ năng sẽ đưa ra hai lựa chọn:

1. **Auto-draft từ codebase (khuyến nghị)**
   - Kỹ năng quét repository của bạn (ví dụ: `README`, landing page, nội dung marketing, `package.json`, v.v.)
   - Soạn bản nháp đầu tiên cho bối cảnh marketing sản phẩm dựa trên những gì tìm thấy
   - Bạn xem lại, chỉnh sửa và mở rộng bản draft V1 này

2. **Bắt đầu từ con số 0**
   - Kỹ năng dẫn bạn qua từng phần một theo dạng hội thoại
   - Bạn trả lời các câu hỏi trọng tâm về sản phẩm, đối tượng và định vị

Trong cả hai trường hợp, khi hoàn tất quy trình, kỹ năng sẽ ghi tài liệu cuối cùng vào:

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

### Các phần được lưu trong file bối cảnh
File bối cảnh do product-marketing-context tạo ra được tổ chức theo các phần thực tế, dễ tái sử dụng. Theo các bản đánh giá đi kèm, kỹ năng được kỳ vọng sẽ bao phủ ít nhất các mảng sau (nếu phù hợp):

- **Product Overview** – Bạn bán gì, sản phẩm làm được gì và dành cho ai
- **Target Audience** – ICP, vai trò, ngành và quy mô công ty mục tiêu
- **Personas** – Các nhân vật then chốt như Product Manager, VP, founder hoặc buyer
- **Problems You Solve** – Pain point, jobs-to-be-done và use case
- **Competitive Landscape** – Bạn cạnh tranh với ai và người mua nhìn nhận các lựa chọn thay thế thế nào
- **Differentiation** – Điều gì khiến sản phẩm của bạn khác biệt một cách có ý nghĩa
- **Objections** – Những lý do phổ biến khiến khách hàng tiềm năng do dự hoặc từ chối
- **Switching Dynamics** – Cần điều gì xảy ra để ai đó chuyển sang dùng sản phẩm của bạn
- **Customer Language** – Cụm từ, trích dẫn và ngôn ngữ khách hàng thực sự sử dụng
- **Brand Voice** – Bạn muốn thương hiệu của mình được thể hiện như thế nào trên các kênh
- **Proof Points** – Testimonial, số liệu, social proof và case study
- **Goals** – Thành công trông như thế nào với hoạt động marketing và go-to-market của bạn

Không phải sản phẩm nào cũng cần điền đầy đủ mọi phần, nhưng kỹ năng được thiết kế để bao quát tất cả các phần liên quan và nhắc bạn bổ sung khi còn thiếu thông tin.

### Sử dụng bối cảnh trong workflow của bạn
Khi `.agents/product-marketing-context.md` đã tồn tại, bạn có thể:

- Tham chiếu tới file này khi chạy các **kỹ năng liên quan đến marketing** khác để chúng cùng chia sẻ hiểu biết về sản phẩm
- Đưa file vào hệ thống quản lý phiên bản trong repository để theo dõi cách định vị thay đổi theo thời gian
- Dùng nó như nguồn tham chiếu nội bộ cho thành viên mới hoặc cộng tác viên

Vì file nằm ở một đường dẫn cố định, nên rất dễ để:

- Các agent khác trong bộ `marketingskills`
- Các công cụ hoặc script tùy chỉnh do bạn tự viết

…tải nó lên và làm việc trên nền tảng bối cảnh marketing sản phẩm thống nhất.

### File và thư mục nên xem
Nếu muốn hiểu sâu hơn hoặc tùy biến, hãy bắt đầu với:

- `SKILL.md` – Định nghĩa cốt lõi của kỹ năng, mô tả và chi tiết workflow
- `evals/evals.json` – Các prompt minh họa và hành vi mong đợi, hữu ích để thấy kỹ năng phản hồi thế nào trong tình huống thực tế

Bạn có thể điều chỉnh cách kỹ năng hoạt động (ví dụ cách gọi hoặc cách chain với các kỹ năng khác) để phù hợp với cấu trúc repository và công cụ tự động hóa của riêng bạn.

## FAQ

### Hiểu đơn giản thì product-marketing-context là gì?
Kỹ năng product-marketing-context là một trợ lý hướng dẫn giúp bạn tạo một tài liệu marketing sản phẩm có cấu trúc — lưu tại `.agents/product-marketing-context.md` — bao quát sản phẩm, đối tượng, định vị và thông điệp chính để các kỹ năng và agent khác có thể tái sử dụng.

### Tôi cài đặt product-marketing-context như thế nào?
Hãy cài từ repository `coreyhaines31/marketingskills` với lệnh:

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

Sau khi cài đặt, bạn có thể mở SKILL.md trong thư mục product-marketing-context để xem chi tiết workflow.

Tài liệu bối cảnh được lưu ở đâu?

Theo mặc định, kỹ năng sẽ tạo và quản lý bối cảnh marketing sản phẩm của bạn tại:

• .agents/product-marketing-context.md

Kỹ năng cũng có thể phát hiện các setup cũ trong .claude/product-marketing-context.md và đề xuất chuyển chúng sang .agents/.

Điều gì xảy ra nếu tôi đã có sẵn file product-marketing-context?

Nếu .agents/product-marketing-context.md đã tồn tại, kỹ năng sẽ:

1. Đọc và tóm tắt nội dung
2. Hỏi bạn muốn thay đổi phần nào
3. Chỉ thu thập thông tin mới cho các phần đó

Nhờ vậy bạn không phải trả lời lại những câu hỏi đã được ghi chép.

product-marketing-context có thể cập nhật bối cảnh khi sản phẩm thay đổi không?

Có. Kỹ năng được thiết kế để hỗ trợ cập nhật từng phần. Ví dụ, nếu bạn:

• Thêm enterprise tier mới
• Mở rộng đối tượng mục tiêu sang các vai trò mới (ví dụ thêm VP of Engineering)
• Điều chỉnh điểm khác biệt hoặc proof points

…bạn chỉ cần gọi lại kỹ năng, nó sẽ giúp bạn cập nhật các phần tương ứng trong .agents/product-marketing-context.md.

Kỹ năng này có tự động soạn nội dung từ codebase của tôi không?

Có thể. Khi chưa có file bối cảnh, product-marketing-context sẽ đưa ra lựa chọn auto-draft from codebase. Ở chế độ này, nó sẽ xem xét các tài liệu có sẵn trong repo (như README, nội dung marketing hoặc metadata của package) để soạn bản nháp đầu tiên, sau đó bạn chỉnh sửa lại.

product-marketing-context kết hợp với các kỹ năng marketing khác như thế nào?

Các kỹ năng tập trung vào marketing khác trong setup của bạn có thể đọc .agents/product-marketing-context.md để:

• Hiểu về sản phẩm và ICP của bạn
• Tái sử dụng giọng thương hiệu và thông điệp
• Giữ sự nhất quán với định vị và mục tiêu

Thông thường, bạn chạy product-marketing-context trước trên một dự án mới, rồi dùng file bối cảnh chung này khi tạo email, landing page, thông báo launch và các tài sản khác.

product-marketing-context có hữu ích cho developer không?

Có. Developer đang xây dựng workflow đa kỹ năng có thể coi .agents/product-marketing-context.md là single source of truth:

• Nằm trong repository
• Dễ parse hoặc load bằng code
• Giữ cho tất cả kỹ năng liên quan đến marketing luôn đồng bộ

Điều này đặc biệt hữu ích trong các hệ thống tự động hóa lớn, nơi nhiều agent cần dùng chung thông tin về sản phẩm và đối tượng.

Tôi nên xem những file nào để hiểu hoặc tùy chỉnh kỹ năng?

Hãy bắt đầu với:

• SKILL.md – Mô tả mục đích của product-marketing-context và workflow chi tiết
• evals/evals.json – Minh họa các prompt và output kỳ vọng, giúp bạn hình dung cách kỹ năng hoạt động trong tình huống thực tế

Sau đó bạn có thể điều chỉnh cách gọi kỹ năng, hoặc chain với các kỹ năng khác, để phù hợp với cấu trúc repository và quy trình marketing của riêng mình.