product-marketing-context

개요

이 스킬이 하는 일

product-marketing-context 스킬은 하나의 재사용 가능한 제품 마케팅 컨텍스트 문서를 만들어 프로젝트 전반에서 활용할 수 있게 도와줍니다.

새 작업마다 제품, 타깃 고객, 포지셔닝을 다시 설명할 필요 없이, 이 스킬이 구조화된 질문 흐름으로 안내하고 그 결과를 다음 위치에 저장합니다.

• .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 기반 마케팅 워크플로를 구성할 때

다음 경우에는 꼭 맞지 않을 수 있습니다.

• 한 번 쓰고 말 카피만 필요하고, 컨텍스트를 재사용할 계획이 없는 경우
• 제품이 매우 초기 단계라 아직 아무런 방향성도 없는 경우 (이때는 먼저 기본 가설을 간단히 적어 두고, 이후에 이 스킬을 돌리는 것이 좋습니다.)

마케팅 관련 작업을 한 번 이상 수행할 계획이라면, 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 스킬은 컨텍스트 파일의 존재 여부에 따라 두 갈래의 간단한 워크플로를 따릅니다.

#### 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 도입)
- 신뢰 근거, 로고, 사례 연구 업데이트

#### 3. 컨텍스트 파일이 없는 경우
컨텍스트 파일이 없으면, 스킬은 두 가지 경로를 제안합니다.

1. **코드베이스에서 자동 초안 생성 (권장)**
   - 저장소의 자료를 살펴봅니다. (예: `README`, 랜딩 페이지, 마케팅 카피, `package.json` 등)
   - 발견한 내용을 바탕으로 제품 마케팅 컨텍스트의 1차 버전을 작성합니다.
   - 사용자가 이 V1 초안을 검토하고 수정·보완합니다.

2. **완전히 처음부터 시작**
   - 각 섹션을 대화 형식으로 하나씩 진행합니다.
   - 제품, 타깃 고객, 포지셔닝에 대해 구체적인 질문을 던지고 답변을 받아 정리합니다.

두 경우 모두, 과정이 끝나면 최종 문서를 다음 위치에 저장합니다.

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

### 컨텍스트 파일에 포함되는 섹션
product-marketing-context가 생성하는 컨텍스트 파일은 실제 활용에 초점을 둔, 재사용 가능한 섹션들로 구성됩니다. 포함된 평가 기준에 따르면, 스킬은 관련이 있는 경우 최소한 다음 영역들을 다루도록 기대됩니다.

- **Product Overview** – 무엇을, 누구를 위해 판매하며, 어떤 역할을 하는지
- **Target Audience** – ICP, 역할, 산업, 회사 규모
- **Personas** – Product Manager, VP, founder, buyer 등 주요 이해관계자
- **Problems You Solve** – 해결하는 페인 포인트, jobs-to-be-done, 주요 사용 사례
- **Competitive Landscape** – 경쟁 대상과 고객이 인식하는 대안
- **Differentiation** – 제품을 의미 있게 차별화시키는 요소
- **Objections** – 잠재 고객이 망설이거나 거절하는 흔한 이유
- **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 추가)
• 차별화 포인트나 신뢰 근거를 조정했을 때

이럴 때 스킬을 다시 호출하면, .agents/product-marketing-context.md에서 관련 섹션만 선택적으로 업데이트할 수 있도록 도와줍니다.

코드베이스에서 내용을 자동으로 가져와 초안을 작성해 주나요?

그럴 수 있습니다. 컨텍스트 파일이 없을 때, product-marketing-context는 auto-draft from codebase 옵션을 제공합니다. 이 모드에서는 저장소 내 README, 마케팅 카피, 패키지 메타데이터 등 사용 가능한 자료를 검토해 첫 버전을 작성하고, 이후 사용자가 이를 다듬습니다.

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 – 예시 프롬프트와 기대 출력이 담겨 있어, 실제 상황에서 스킬이 어떻게 동작해야 하는지 파악하는 데 도움이 됩니다.

이후에는 저장소 구조와 마케팅 프로세스에 맞춰 스킬 호출 방식이나 다른 스킬과의 체이닝을 자유롭게 조정할 수 있습니다.