case-study-writing

개요

case-study-writing 스킬은 무엇인가요?

case-study-writing 스킬은 STAR 프레임워크(Situation → Task → Action → Result)를 기반으로 명확하고 신뢰도 높은 B2B 케이스 스터디를 만들 수 있게 도와주는 가이드형 워크플로우입니다. inference.sh 스킬로 구현되어 있어, 에이전트가 실제 비즈니스 성과를 강조하는 고객 스토리를 리서치하고, 아웃라인을 짜고, 초안을 작성하도록 안내합니다.

빈 문서에서 시작하는 대신, 이 스킬은 에이전트를 다음 단계별로 안내합니다:

• Situation과 고객의 배경·맥락 설정
• 구체적인 Task 또는 과제 정의
• Action(당신의 솔루션과 도입 방식) 설명
• 지표, 전/후 비교, 비주얼을 활용해 Result를 수치화

어떤 사람에게 적합한가요?

case-study-writing 스킬은 다음과 같은 콘텐츠가 필요할 때 활용하기 좋습니다:

• SaaS, 서비스, B2B 제품을 위한 고객 성공 스토리
• 성과를 증명하는 세일즈 인에이블먼트 자료
• 웹사이트, 프레젠테이션, 캠페인용 마케팅 케이스 스터디
• 에이전시, 컨설턴트, 프리랜서를 위한 포트폴리오용 사례 콘텐츠

다음과 같은 팀에 잘 맞습니다:

• 마케팅 및 콘텐츠 마케팅
• 고객 마케팅 및 고객 성공(Customer Success)
• 세일즈 및 세일즈 엔지니어링
• 에이전시 및 B2B 컨설턴트

어떤 문제를 해결하나요?

이 스킬은 케이스 스터디 작성 시 자주 발생하는 문제를 해결하도록 설계되었습니다:

• 실제 비즈니스 임팩트가 느껴지지 않고 공허하게 들리는 스토리
• 중요한 결과가 묻혀버리는 비구조적인 초안
• 신뢰도를 떨어뜨리는 빈약하거나 누락된 지표
• 고객 산업·맥락에 대한 리서치 부족

저장소에 정의된 STAR 구조와 권장 분량을 따름으로써, 에이전트는 각 섹션에 집중도를 유지하고 전체 분량을 800–1200 단어 수준으로 맞춰, 정보량과 가독성을 균형 있게 유지합니다.

언제 case-study-writing을 쓰면 좋을까요?

다음과 같은 경우 이 스킬을 선택하는 것이 좋습니다:

• 측정 가능한 성과를 가진 제품 또는 서비스를 보유하고 있을 때
• 여러 건의 케이스 스터디에서 일관된 브랜드 톤과 구조를 유지하고 싶을 때
• 에이전트가 일반적인 마케팅 문구 대신 리서치와 데이터를 기반으로 쓰기를 원할 때
• 작성한 케이스 스터디를 세일즈 데크, 랜딩 페이지, 소셜 캠페인 등에서 재사용할 계획이 있을 때

다음과 같은 경우에는 적합하지 않습니다:

• 짧은 추천사나 한 줄짜리 코멘트만 필요할 때
• 순수 기술 문서나 사용자 매뉴얼을 작성할 때
• 고객 이름, 지표, 결과를 언급할 권한이 없고 익명 처리도 불가능할 때

사용 방법

사전 준비 사항

저장소의 스킬 정의에 따르면, 이 스킬은 **inference.sh CLI(infsh)**에서 실행되도록 설계되었습니다.

다음 환경을 갖추는 것이 좋습니다:

• 스킬 설치를 위한 npx 사용을 위해 Node.js 설치
• Quick Start 리서치 단계를 따를 계획이라면 infsh CLI 접근 권한

소스에 나온 리서치 플로우를 그대로 활용하려면, 아래 공식 안내에 따라 inference.sh CLI를 설치하세요:

• https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

설치 절차

Agent Skills Finder 설치 커맨드를 사용해 에이전트 환경에 스킬을 추가합니다:

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

이 명령은 inferen-sh/skills 저장소의 guides/writing/case-study-writing 아래에 있는 case-study-writing 스킬 정의와 관련 가이드 파일들을 가져옵니다.

설치 후 아래 파일을 확인하세요:

• 표준 설명과 워크플로우가 담긴 SKILL.md
• 상세 구조와 예시가 있는 guides/writing/case-study-writing 하위의 참조 가이드들

STAR 기반 핵심 워크플로우

설치가 완료되면, case study, customer story, success story, B2B case study, client testimonial 같은 트리거를 프롬프트에 언급해 case-study-writing 사용을 지시할 수 있습니다.

일반적인 워크플로우는 다음과 같습니다:

1. 입력 정보 수집
   에이전트에게 다음 정보를 제공합니다:

   • 고객 이름과 산업(또는 익명 처리된 등가 정보)
   • 고객이 사용한 제품 또는 서비스
   • 주요 과제와 알려진 지표
   • 인터뷰에서 나온 메모나 발언(있다면)

2. 고객 맥락 리서치(선택 사항, infsh 사용)
   SKILL 가이드에는 inference.sh CLI를 사용한 외부 리서치 예시가 포함되어 있습니다. 예를 들어:

   infsh login
   
   # Research the customer's industry
   infsh app run tavily/search-assistant --input '{
     "query": "SaaS customer onboarding challenges 2024 statistics"
   }'
   

   이 쿼리를 제조, 핀테크, 이커머스 등 고객 산업에 맞게 바꿔 사용하면, Situation과 Task 섹션을 강화해 줄 최신 통계와 트렌드를 수집할 수 있습니다.

3. STAR 구조로 초안 작성
   스킬에서는 대략 다음과 같은 구조와 분량을 권장합니다:

   • Situation (100–150 words) – 고객이 누구인지, 어떤 상황에 있었는지, 기존 상태가 왜 충분하지 않았는지.
   • Task (100–150 words) – 비즈니스 관점에서 본 구체적인 과제 또는 목표(예: 이탈률 감소, 리드 품질 개선, 온보딩 기간 단축).
   • Action (200–300 words) – 어떤 솔루션을 도입했는지, 어떻게 작동하는지, 제품·서비스의 강점을 보여주는 핵심 구현 단계.
   • Result (100–200 words) – 전/후 비교, 타임라인, 핵심 KPI를 포함한 정량적 성과.

   프롬프트에서 에이전트에게 다음을 명시적으로 지시하세요:

   • STAR 프레임워크 순서대로 작성할 것
   • 전체 분량을 800–1200 단어 범위 안으로 유지할 것
   • 각 섹션을 명확히 구분할 것

4. 지표, 비주얼, 고객 발언 추가
   이 스킬의 설명에서는 다음 요소를 강조합니다:

   • 지표 제시 방식 – 전환율, 매출 영향, 절감된 시간, 오류 감소율 등 핵심 메트릭을 분명히 드러내고, 이후 디자이너가 구현할 수 있는 수준의 간단한 비주얼 아이디어(예: 전/후 막대 그래프, 퍼널 이탈률 그래프)를 제안하도록 에이전트에 요청하세요.
   • 고객 발언 – 인터뷰 메모를 제공했다면, Task, Action, Result 섹션과 자연스럽게 맞물리는 임팩트 있는 인용문 1–3개를 제안하도록 지시할 수 있습니다.

5. 유통·활용 포맷 설계
   메인 내러티브가 승인된 뒤에는, 같은 스킬 컨텍스트를 유지한 채 에이전트에게 케이스 스터디를 다음과 같은 포맷으로 재구성하도록 요청할 수 있습니다:

   • 1페이지짜리 세일즈 PDF 아웃라인
   • 세일즈 데크용 슬라이드 헤드라인
   • 핵심 성과를 강조하는 짧은 소셜 미디어 포스트
   • 웹사이트/블로그용 케이스 스터디 요약 카피

워크플로우에 맞게 스킬 활용 커스터마이징

저장소에서는 이 스킬을 워크플로우 템플릿으로 활용할 것을 권장하며, 고정된 스크립트로 볼 필요는 없습니다. 예를 들어 다음과 같이 조정할 수 있습니다:

• 산업 특성상 기술적인 설명이 많이 필요하다면 섹션별 분량 조정
• 예시에 나온 tavily/search-assistant 대신 자사 리서치 도구나 데이터 소스를 사용
• STAR 아웃라인을 CMS나 제안서 템플릿에 통합

에이전트를 설정할 때, “draft customer success story”, “write SaaS onboarding case study” 같은 선호 트리거 문구를 case-study-writing에 매핑해 두면 팀 전체에서 일관되게 워크플로우를 호출할 수 있습니다.

자주 묻는 질문(FAQ)

case-study-writing 스킬은 정확히 무엇을 해주나요?

case-study-writing 스킬은 STAR 프레임워크를 활용해 B2B 케이스 스터디를 구조적으로 작성하도록 에이전트를 안내합니다. 리서치 기반의 배경(Context), 명확한 문제 정의, 솔루션에 대한 구체적 설명, 그리고 지표·인용·비주얼 제안으로 뒷받침되는 결과를 강조합니다.

case-study-writing은 어떻게 설치하나요?

다음 명령을 실행하세요:

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

그런 다음 설치된 저장소에서 SKILL.md를 열면 Quick Start와 STAR 프레임워크 표를 포함한 전체 사용 설명을 확인할 수 있습니다.

inference.sh CLI(infsh)를 반드시 써야 하나요?

SKILL 가이드에는 tavily/search-assistant를 활용해 리서치를 수행하는 inference.sh CLI(infsh) 예시 명령이 나와 있습니다. 자동화된 산업 리서치가 필요하다면 사용하는 것을 권장하지만, 다음과 같이 대체할 수도 있습니다:

• 유사한 리서치 워크플로우를 자체 도구로 실행하거나
• 직접 수집한 리서치 자료를 에이전트에 제공하는 방식

case-study-writing의 핵심 구조(STAR 및 분량 가이드)는 infsh 없이도 그대로 활용할 수 있습니다.

좋은 결과를 얻으려면 어떤 정보를 준비해야 하나요?

case-study-writing 스킬로 강력한 케이스 스터디를 만들려면 다음 정보를 준비하는 것이 좋습니다:

• 고객 배경(산업, 규모, 위치, 제품 사용 방식)
• 주요 비즈니스 과제 또는 목표
• 구현 상세(제품/서비스가 실제로 어떻게 사용되었는지)
• 정량적 결과(KPI의 전/후 수치)
• 인터뷰 메모 또는 고객 발언

입력이 풍부할수록, 최종 케이스 스터디는 더 구체적이고 신뢰도 높은 결과물을 제공합니다.

B2B가 아닌 스토리에도 case-study-writing을 사용할 수 있나요?

이 스킬은 측정 가능한 비즈니스 지표를 가진 B2B 사례에 최적화되어 있습니다. B2C 사례나 내부 변화 관리 스토리에도 응용할 수는 있지만, 구조·톤·KPI 중심 설계는 B2B 케이스 스터디를 기준으로 만들어졌다는 점을 염두에 두어야 합니다.

완성된 케이스 스터디 분량은 어느 정도인가요?

저장소에 정의된 STAR 프레임워크 가이드에 따르면 권장 분량은 800–1200 단어입니다. 이 정도면 충분한 배경 설명, 솔루션 소개, 성과 증명을 할 수 있으면서도 독자를 지치게 하지 않는 분량입니다.

이 스킬은 소셜 미디어 포스트나 광고에도 적합한가요?

case-study-writing은 기본적으로 리포트 스타일의 롱폼 콘텐츠 워크플로우입니다. 완성된 케이스 스터디를 기반으로 다음과 같이 재활용하기에 좋습니다:

• 소셜 미디어용 짧은 스니펫
• 세일즈 아웃리치 이메일
• 슬라이드나 원페이지 자료

순수 광고 카피나 극단적으로 짧은 소셜 콘텐츠만 필요하다면, 이 스킬로 만든 케이스 스터디를 소스 자료로 활용하면서, 별도의 특화 카피라이팅 스킬과 함께 사용하는 것이 더 적합할 수 있습니다.

이 스킬의 전체 파일과 규칙은 어디에서 볼 수 있나요?

설치 후 에이전트 환경에서 스킬 디렉터리를 열어 다음 파일을 확인하세요:

• SKILL.md – 주요 설명과 사용 가이드
• guides/writing/case-study-writing 아래의 추가 가이드들

Agent Skills Finder의 Files 탭이나 로컬 에디터에서 전체 디렉터리 트리를 살펴보면, 저장소에서 제공하는 모든 참조 자료와 헬퍼 파일을 확인할 수 있습니다.