data-storytelling
작성자 wshobsondata-storytelling 스킬을 활용하면 분석 결과를 보고서, 임원 업데이트, 이해관계자 커뮤니케이션에 바로 쓸 수 있는 의사결정용 내러티브로 구조화하고, 메시지와 실행 포인트를 더 명확하게 정리할 수 있습니다.
이 스킬은 68/100점으로, 디렉터리 사용자에게 소개할 만하지만 한계는 분명히 안내해야 하는 수준입니다. 저장소에는 분석 결과를 내러티브로 전환하는 방법에 대한 문서가 비교적 충실하게 정리되어 있으며, 활용 사례, 스토리 구조, 프레임워크도 포함되어 있어 에이전트가 적용 시점을 판단하고 일반적인 프롬프트보다 더 구조화된 출력을 만드는 데는 도움이 될 가능성이 큽니다. 다만 이 스킬은 문서 중심 구성에 머물러 있고, 스크립트, 파일과 연결된 예시, 설치/실행 방법 같은 구체적인 실행 보조 수단은 부족하므로 실제 사용에서는 어느 정도 시행착오를 예상해야 합니다.
- 적용 신호가 뚜렷합니다: 설명과 'When to Use' 섹션이 임원 발표, 보고서, 이해관계자 커뮤니케이션을 명확하게 대상으로 제시합니다.
- 실무형 내용이 담겨 있습니다: 자리 채우기용 설명이 아니라 정의된 스토리 구조, 내러티브 아크, 재사용 가능한 프레임워크를 제공합니다.
- 에이전트 활용 가치가 있습니다: 원시 분석 결과를 시각 요소, 맥락, 권고안을 갖춘 이해관계자용 내러티브로 반복 가능하게 전환하는 방식을 제시합니다.
- 운영 측면 지원은 제한적입니다: 문서형 안내 외에 에이전트 실행을 도울 스크립트, 참조 자료, 지원 파일, 설치 지침이 없습니다.
- 문서 분량에 비해 실무 구체성은 다소 약합니다: 구체적 예시, 제약 조건 처리, 처음부터 끝까지 이어지는 완성형 산출물의 근거는 제한적입니다.
data-storytelling 스킬 개요
data-storytelling 스킬이 하는 일
data-storytelling 스킬은 원시 분석 결과를 의사결정에 바로 쓸 수 있는 커뮤니케이션으로 바꾸는 데 도움을 줍니다. 차트에서 멈추지 않고, 맥락·긴장감·인사이트·행동 제안이 있는 내러티브로 결과를 구조화하도록 밀어주는 것이 핵심입니다. 단순히 “데이터를 분석하는 일”이 아니라 “무엇이 중요한지, 다음에 무엇을 해야 하는지 설명하는 일”이 실제 업무인 경우 특히 유용합니다.
보고서 작성과 이해관계자 커뮤니케이션에 가장 잘 맞는 경우
이 data-storytelling 스킬은 경영진이나 비기술 독자에게 지표를 설명해야 하는 분석가, 운영 담당자, 컨설턴트, 창업자, 보고서 작성자에게 잘 맞습니다. 특히 data-storytelling for Report Writing, 분기 리뷰, 이사회 업데이트, 투자자용 덱, 추천 메모 같은 용도와 잘 맞습니다.
일반적인 프롬프트와 다른 점
보통의 프롬프트는 숫자를 요약하는 데 그치기 쉽습니다. 반면 data-storytelling 스킬은 재사용 가능한 커뮤니케이션 프레임을 제공합니다. 예를 들어 setup, conflict, resolution, 혹은 hook, context, rising action, climax, resolution, call to action 같은 구조와, 데이터·서사·시각자료 사이의 균형을 함께 다룹니다. 덕분에 분석은 정확하지만 기억에 남지 않는 흔한 실패를 줄일 수 있습니다.
설치 전에 먼저 따져볼 점
도입 판단의 핵심은 단순합니다. 필요한 것이 설득력 있는 설명인지, 아니면 분석 결과 그 자체인지입니다. 청중이 의미, 트레이드오프, 다음 단계까지 이해해야 한다면 이 스킬은 분명한 가치를 더합니다. 반대로 SQL 도움, 차트 생성, 원시 지표 요약만 필요하다면 이 스킬 하나만으로는 다소 추상적이고 상위 레벨일 수 있습니다.
저장소에 포함된 내용
이 스킬은 매우 가볍습니다. 저장소 기준으로는 핵심 가이드를 담은 단일 SKILL.md만 있으며, 추가 스크립트, rules, reference는 없습니다. 즉 설정은 쉽지만, 실제 결과물의 품질은 프롬프트의 품질과 제공하는 데이터 맥락에 크게 좌우됩니다.
data-storytelling 스킬 사용 방법
data-storytelling 설치 맥락
상위 저장소에서 스킬을 설치한 뒤, AI 워크플로에서 호출하면 됩니다.
npx skills add https://github.com/wshobson/agents --skill data-storytelling
이 스킬은 plugins/business-analytics/skills/data-storytelling에 들어 있으므로, 실행형 분석 툴체인을 가져오는 것이 아니라 분석 커뮤니케이션용 내러티브 프레임워크를 가져온다고 이해하는 편이 정확합니다.
먼저 읽어야 할 파일
다음 파일부터 확인하세요.
SKILL.md
이 스킬에는 별도의 README.md, rules/, resources/, 헬퍼 스크립트가 드러나 있지 않으므로, 실질적인 가치는 거의 모두 SKILL.md 안의 프레임워크를 이해하고 적용하는 데 있습니다.
잘 작동하려면 어떤 입력이 필요한가
data-storytelling 스킬은 데이터셋을 통째로 던지는 방식보다, 의도가 분명한 입력을 줄 때 훨씬 잘 작동합니다. 가능하면 아래를 함께 주세요.
- 청중: executive, client, manager, board, investor, customer
- 형식: report, memo, slide outline, brief, spoken update
- 지원하려는 의사결정: invest, cut, prioritize, diagnose, explain
- 핵심 지표와 기간
- 기준선 또는 비교 기준점
- 가장 중요한 발견
- 이미 알고 있는 한계나 불확실성
- 원하는 행동
이 정보 없이도 모델이 그럴듯한 이야기를 만들 수는 있지만, 겉보기만 매끄럽고 비즈니스 관련성이 빠질 위험이 큽니다.
거친 목표를 강한 프롬프트로 바꾸기
약한 목표:
- “Write a data story about churn.”
더 강한 data-storytelling usage 프롬프트:
- “Use the data-storytelling skill to turn this churn analysis into a report section for a VP of Customer Success. Audience is non-technical. Goal is to justify retention investment for Q3 planning. Use setup-conflict-resolution. Start with a strong hook, explain the baseline, identify the most important driver, quantify business impact, note confidence limits, and end with 3 recommended actions.”
이렇게 하면 청중, 의사결정, 구조, 마무리 기대치가 모두 분명해지므로 결과가 훨씬 좋아집니다.
권장 프롬프트 템플릿
일관된 결과를 원한다면 아래 같은 템플릿을 쓰는 것이 좋습니다.
- Objective: 이 보고서가 달성해야 할 목표
- Audience: 읽는 사람
- Data: 핵심 숫자, 추세, 비교
- Context: 무엇이 바뀌었고 왜 중요한지
- Constraints: 톤, 길이, 형식, 확실성 수준
- Output request: 원하는 내러티브 구조, 제안할 시각자료, 추천안
예시:
- “Apply the data-storytelling skill. Write a 500-word executive summary for a quarterly business review. Data: revenue +8% QoQ, gross margin -3 pts, churn concentrated in SMB accounts, CAC rising 12%. Context: leadership deciding whether to shift budget from acquisition to retention. Include hook, context, rising action, key insight, recommendation, and next steps.”
보고서 작성을 위한 권장 워크플로
data-storytelling for Report Writing에 실무적으로 쓸 만한 워크플로는 다음과 같습니다.
- 중요한 지표 몇 개만 추립니다.
- 긴장 요소를 찾습니다: 하락, 격차, 위험, 기회, 예상 밖 변화.
- 누가 의사결정자인지 청중을 정합니다.
- 모델에게 내러티브 아크 초안을 쓰게 합니다.
- “climax”가 정말로 의사결정에 가장 중요한 인사이트인지 검토합니다.
- 스토리라인이 안정된 뒤에만 시각자료 추천을 붙입니다.
- 핵심 의사결정에 기여하지 않는 내용은 덜어냅니다.
이 순서는 중요합니다. 약한 보고서 상당수는 차트를 너무 많이 넣는 것부터 시작하고, 정작 명확한 스토리가 없다는 사실을 너무 늦게 발견합니다.
어떤 프레임워크를 골라야 하는가
원본 스킬은 오래 써도 무너지지 않는 몇 가지 구조를 강조합니다. 실무적으로는 다음처럼 고르면 됩니다.
- 간결한 메모나 보고서 섹션이 필요하면
Setup → Conflict → Resolution - 프레젠테이션이나 경영진 브리핑이 필요하면 더 긴 narrative arc
- 초안이 한쪽으로 치우쳐 보이면 data, narrative, visuals의 세 축
설치 여부를 가늠하는 좋은 기준도 있습니다. 팀에서 “흥미롭긴 한데 실행으로 이어지지 않는” 분석이 반복된다면, 이 스킬은 도입할 가치가 높습니다.
좋은 입력의 모습
더 좋은 입력은 비교가 가능하고 의사결정과 직접 연결되어 있습니다. 예를 들면:
- “Conversion dropped from 4.2% to 3.1% after pricing changes”
- “Enterprise renewals offset SMB churn, masking segment risk”
- “Support backlog rose 28% while NPS fell 6 points”
- “The business choice is whether to hire support staff or reduce onboarding friction”
이런 입력은 숫자만 따로 주는 것보다 훨씬 강합니다. 긴장을 만들고, 왜 누군가가 이 내용을 신경 써야 하는지까지 설명해 주기 때문입니다.
흔한 사용 실수
약한 data-storytelling usage 결과는 대체로 아래 실수 중 하나에서 나옵니다.
- 청중을 밝히지 않은 채 “설득력 있는 스토리”만 요청함
- 기준선 없이 지표만 제공함
- 추천안을 빼먹음
- 관찰된 패턴을 전부 서사에 욱여넣음
- 서술적 데이터로 인과관계를 단정함
- 시각자료를 근거가 아니라 장식처럼 다룸
이 스킬은 메시지를 하나의 중심 인사이트와 하나의 분명한 실행 경로로 좁힐 때 가장 잘 작동합니다.
일반적인 분석 업무와의 관계
data-storytelling 스킬은 분석, 데이터 정제, 차트 제작을 대체하지 않습니다. 그 단계들 다음에 위치합니다. 좋은 워크플로는 먼저 분석을 끝내고, 그다음 이 스킬로 결과를 경영진이 훑어봐도 살아남는 내러티브로 패키징하는 것입니다.
어떤 출력 형식을 요청하면 좋은가
다음과 같은 출력 요청이 실용적입니다.
- executive summary
- board-ready memo
- quarterly review narrative
- investor update section
- slide-by-slide outline
- insight-to-action brief
- annotated chart captions
그냥 “스토리 하나 써줘”라고 하면, 의사결정에 쓸모 없는 문체만 얻는 경우가 많습니다. 대신 비즈니스 문서 유형을 명시해서 요청하세요.
data-storytelling 스킬 FAQ
data-storytelling 스킬은 초보자에게도 괜찮은가?
그렇습니다. 이미 데이터나 발견사항이 있다면, 프레임워크 자체는 단순하고 접근하기 쉽습니다. 다만 초보자는 무엇이 가장 중요한 단일 인사이트인지 고르는 데 어려움을 겪을 수 있으니, 본문을 쓰기 전에 모델에게 발견사항을 비즈니스 영향도 기준으로 순위화해 달라고 먼저 요청하면 도움이 됩니다.
일반 요약 프롬프트 대신 언제 써야 하나?
청중이 설득, 맥락, 권장 행동까지 필요로 할 때는 data-storytelling skill을 쓰는 편이 맞습니다. 결과를 사실 중심으로 짧게 정리하기만 하면 될 때는 일반 요약 프롬프트가 더 적절합니다.
이 스킬은 발표 자료용으로만 쓰이나?
아닙니다. 보고서, 메모, 경영진 이메일, 분기 리뷰, 투자자 대상 문서에도 똑같이 유용합니다. 핵심 가치는 슬라이드 자체가 아니라 내러티브 구조에 있습니다.
data-storytelling install에 차트나 자동화가 포함되나?
이 스킬에 내장 스크립트, 차트 도구, 자동화 기능이 있다는 근거는 없습니다. data-storytelling install로 얻는 것은 커뮤니케이션 프레임워크이지, 시각화 엔진이나 리포팅 파이프라인이 아닙니다.
기술적 독자를 상대로도 쓸 수 있나?
가능합니다. 다만 진가는 혼합 청중이나 비기술 청중에서 더 크게 드러납니다. 아주 기술적인 독자에게는 서사 장치를 조금 덜고, 방법론 설명을 늘린 더 직접적인 구조가 더 나을 수 있습니다.
어떤 경우에는 잘 맞지 않나?
다음과 같다면 이 스킬은 건너뛰는 편이 좋습니다.
- 아직 분석 검증이 끝나지 않았을 때
- 청중이 원시 테이블이나 기술 부록만 원할 때
- 의사결정이 너무 단순해서 설득이 필요 없을 때
- 커뮤니케이션 구조보다 도메인 특화 통계 엄밀성이 더 중요할 때
슬라이드 작성 스킬과는 어떻게 다른가?
슬라이드 작성 스킬은 형식과 발표 흐름에 초점을 둡니다. 여기의 data-storytelling guide는 그보다 앞단에서, 근거를 먼저 의미로 조직하는 데 초점이 있습니다. 슬라이드, 보고서, 구두 브리핑을 쓰기 전에 모두 적용할 수 있습니다.
data-storytelling 스킬 개선 방법
데이터셋이 아니라 의사결정에서 시작하기
data-storytelling 결과를 가장 빠르게 개선하는 방법은, 스토리가 어떤 의사결정을 지원해야 하는지 먼저 정의하는 것입니다. “이 대시보드를 요약해줘”는 약합니다. “이 churn이 retention 투자까지 정당화하는지 leadership가 판단할 수 있게 도와줘”는 훨씬 강합니다.
긴장 요소를 명시적으로 주기
스토리에는 갈등이 필요합니다. 프롬프트에 그 요소가 없으면, 모델이 억지로 드라마를 만들거나 밋밋한 문장을 내놓기 쉽습니다. 긴장을 직접 써 주세요.
- 성장하지만 마진은 하락
- 매출은 늘지만 유지율은 악화
- 어떤 세그먼트의 성과가 다른 세그먼트의 손실을 가림
- 상단 지표는 좋아지지만 운영 리스크는 커짐
스토리를 쓰기 전에 인사이트를 먼저 순위화하기
최종 내러티브를 요청하기 전에, 먼저 아래 작업을 시키세요.
- 상위 3개 발견사항 식별
- 비즈니스 중요도 기준 순위화
- 그중 하나를 중심 메시지로 선택
- 어떤 의사결정에 영향을 줘야 하는지 설명
이 과정을 거치면 첫 초안이 한꺼번에 다섯 가지 이야기를 하려 드는 흔한 문제를 막을 수 있습니다.
기준선과 비교값 추가하기
비교가 있어야 서사가 설득력을 얻습니다. data-storytelling guide 입력을 아래처럼 보강해 보세요.
- 이전 기간 vs 현재 기간
- 목표 vs 실제
- 세그먼트 vs 세그먼트
- 개입 전 vs 개입 후
- 내부 추세 vs 시장 벤치마크
비교 없는 스토리는 대개 인사이트보다 단순 묘사처럼 읽힙니다.
확실성 수준을 통제하기
대표적인 실패 패턴 중 하나는 데이터가 입증하는 범위를 과장하는 것입니다. 발견사항이 descriptive인지, directional인지, causal인지 모델에 분명히 알려 주세요. 그리고 다음을 구분해서 쓰도록 요청하세요.
- 데이터가 보여주는 것
- 무엇이 원인일 가능성이 높은지
- 무엇을 추가 검증해야 하는지
특히 경영진이나 투자자 상대 문서에서는 이런 구분이 신뢰도를 크게 높입니다.
내러티브가 안정된 뒤에만 시각자료 요청하기
원본 스킬은 visuals의 가치를 인정하지만, 차트는 스토리를 이끄는 것이 아니라 뒷받침해야 합니다. 실무적으로는 아래 순서가 유용합니다.
- hook와 핵심 메시지를 먼저 맞춘다
- conflict와 근거를 검증한다
- recommendation을 다듬는다
- 그다음 각 포인트를 가장 잘 설명할 차트를 묻는다
섹션 제약을 걸어 보고서 출력 품질 높이기
data-storytelling for Report Writing에서는 섹션별 동작을 구체적으로 지정하면 결과가 눈에 띄게 좋아집니다.
- opening sentence는 비즈니스 stakes를 바로 말해야 함
- context paragraph는 기준선을 정의해야 함
- evidence section은 3개의 근거만 사용해야 함
- recommendation section은 owner, timing, expected impact를 포함해야 함
이런 제약은 결과물을 실질적으로 더 유용하게 만듭니다. 행동 가능성을 강제하기 때문입니다.
번듯하지만 내용이 빈 출력 고치기
첫 초안이 그럴듯하지만 비어 보인다면, 아래 지시를 하나 이상 추가해 수정해 보세요.
- “Use the exact numbers provided.”
- “Name the affected segment explicitly.”
- “State the tradeoff behind the recommendation.”
- “Cut any claim not supported by the data.”
- “Replace abstract language with operational implications.”
- “End with a concrete next step.”
문장 표현만이 아니라 내러티브 품질을 기준으로 반복하기
톤만 손보지 마세요. 초안에 아래 요소가 있는지 평가해야 합니다.
- 분명한 hook
- 청중이 이해할 만큼 충분한 맥락
- 기억에 남는 핵심 인사이트 하나
- 납득 가능한 recommendation
- 누군가 바로 실행할 수 있는 next step
이 중 하나라도 빠졌다면 문제는 문장이 아니라 구조에 있습니다.
data-storytelling 중심의 재사용 가능한 팀 표준 만들기
팀이 반복적으로 보고서를 쓴다면, data-storytelling skill 위에 audience, decision, metrics, baseline, risk, confidence, recommendation 같은 고정 필드를 둔 표준 프롬프트 래퍼를 만들어 두세요. 이렇게 하면 편차가 줄고, 반복적인 비즈니스 리뷰에서도 스킬을 더 안정적으로 사용할 수 있습니다.
