Communitygithub.com

deck-narrative

프레젠테이션의 슬라이드나 시각 자료를 만들기 전에 스토리, 청중 인식 계약, 슬라이드별 논제를 설계합니다. 새 데크나 데크 리뉴얼 시작 시 사용하여 NARRATIVE.md를 생성하고, 적절한 내러티브 아크(키노트, 피라미드, SCQA, 기술 워크스루, 피치)를 선택하며, 모든 계획된 시각 자료나 Morph 전환을 스토리 서비스에 정당화합니다.

deck-narrative란 무엇인가요?

Deck Narrative (Story Architect)는 프레젠테이션 디자인에서 내러티브를 가장 우선시하는 스킬입니다. 이 스킬은 시각 자료나 Morph 전환을 만들기 전에 먼저 `NARRATIVE.md`를 잠그도록 하여, 모든 시각적 요소가 청중의 이해와 감정적 인상을 강화하도록 보장합니다. 주로 Claude Code 환경에서 사용되며, 청중 분석, 인식 계약(Think/Feel/Do/Anti-Perception), 내러티브 작업에 따른 경험 형식 선택(연속 3D 카메라 여정, 필름 편집 다큐멘터리 비트, 무한 공간 캔버스, 편집 매거진/비대칭 벤토 등), 슬라이드별 스토리보드 테이블 작성을 포함합니다. 피라미드, SCQA, 키노트 텐션-릴리스, 기술 워크스루 등 다양한 스토리 아크를 지원합니다. 이 스킬의 핵심은 모든 시각적 요소(3D 객체, 차트, Morph 전환)가 청중이 더 빠르게 이해하거나 더 깊이 느끼는 데 기여해야 한다는 원칙을 강조하며, 슬라이드당 하나의 메시지, 고아 슬라이드 금지, 모든 시각 자료의 정당화라는 세 가지 가드레일을 통해 강력한 내러티브 기반의 프레젠테이션을 구축할 수 있게 해줍니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SwePalm/deckcraft-skills/tree/HEAD/skills/deck-narrative

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

데크 내러티브 (스토리 설계자)

내러티브는 길잡이입니다. 멋진 3D 렌더링, 셰이더, Morph 전환은 청중의 이해와 감정적 인상을 선명하게 할 때만 데크를 훌륭하게 만듭니다. 모든 데크는 deck-visuals나 deck-builder를 건드리기 전에 NARRATIVE.md 를 먼저 확정하는 것으로 시작합니다.

NARRATIVE.md가 반드시 포함해야 할 내용

다음 네 가지 필수 섹션으로 NARRATIVE.md를 작성하세요:

  1. 청중 및 전달 방식

    • 방에 있는 사람은 누구인가 (임원, 엔지니어, 투자자, 고객)?
    • 전달 방식: live (발표자가 말함; 슬라이드는 약 40단어 이하로 유지하고 시각적 임팩트를 전달) 또는 preread (혼자/비동기로 읽음; 슬라이드는 최대 약 100단어의 완전한 요점을 전달).
    • 목표 런타임 및 슬라이드 예산 (live 데크의 경우 슬라이드당 약 1.5–2분).
  2. 인식 계약 (deck-eval 게이트 2에 제공!)

    • 생각: 청중이 마지막에 반드시 믿어야 할 하나의 논지는 무엇인가?
    • 느낌: 데크가 불러일으켜야 할 감정적 분위기는 무엇인가 (예: 차분한 기술적 권위, 긴박한 추진력, 편집적 명확성)?
    • 행동: 마지막 슬라이드 직후에 어떤 구체적인 결정이나 행동이 일어나야 하는가?
    • 반인식 (절대 느껴서는 안 되는 것): 이 데크가 절대 느껴져서는 안 되는 2–3가지 (예: 과장된 AI 쓰레기, 빽빽한 스프레드시트 덤프, 일반적인 기업 피치).
  3. 내러티브 작업 → 경험 형식 (기본 슬라이드 문법 깨기) 모든 스토리가 Kicker + 헤더 + 콘텐츠 상자 슬라이드에 속한다고 가정하지 마세요. 내러티브 작업이 경험 형식을 선택하도록 하세요:

    • 발견 및 직관 (과학적 돌파구, 미스터리, "실제 작동 방식") → 연속 3D 카메라 여정 + 필름 비트 (하나의 살아있는 3D 세계, 제로 슬라이드 헤더, 정지 지점 간 카메라 비행).
    • 제품 공개 / 비전 전환 → 필름 편집 다큐멘터리 비트 (와이드 분위기 샷 → 기념비적 120pt+ 긴장감 통계 → 라이브 애니메이션 데모 → 조용한 마무리).
    • 복잡한 시스템 / 전략 → 무한 공간 캔버스 (Morph를 통해 서브시스템으로 패닝 및 확대/축소하는 하나의 통합 맵).
    • 임원 결정 / 사전 읽기 → 편집 매거진 / 비대칭 벤토 (피라미드 아크, D3 데이터 시각화, 명확한 결정).
    • 자기 주도 탐색 → 이중 아티팩트 인터랙티브 웹 스토리 → 컴파일된 .pptx.

    또한 스토리 아크를 선택하세요 (references/narrative-patterns.md 참조):

    • 피라미드 (임원 / 결정): 답변 먼저 → 지지 기둥 → 증거 → 결정/다음 단계.
    • SCQA (전략 / 피치): 상황 → 문제점 → 질문 → 답변 + 증거.
    • 키노트 긴장-해소: 현상 유지 → 균열/통찰 → 새로운 세계 → 증거/데모 → 모험으로의 부름.
    • 기술 워크스루: 문제/제약 → 시스템 멘탈 모델 → Morph 확대해서 서브시스템으로 → 트레이드오프 및 결과.
  4. 슬라이드별 스토리보드 테이블 모든 슬라이드에 대해 다음을 지정하세요:

    • 슬라이드 번호 및 역할 (제목, 긴장감, 기둥 개요, Morph 확대, 데이터 증거, 아키텍처, 마무리)
    • 헤드라인 (주제 레이블이 아닌 논제): 예: "Morph는 정적 아키텍처를 안내된 집중으로 바꾼다" ("아키텍처 개요"가 아님). 헤드라인은 마침표로 끝나지 않음.
    • 핵심 포인트 및 발표자 노트 큐: 청중이 읽는 내용과 발표자가 말하는 내용.
    • 시각 / 모션 정당화: 이 슬라이드가 Morph 전환, Three.js 3D 시각화, 편집 차트 또는 순수 타이포그래피를 사용하는 이유. 시각 자료가 논제를 명확히 하거나 높이지 않으면 삭제하세요.

내러티브 가드레일

  • 슬라이드당 하나의 메시지. 슬라이드에 두 개의 경쟁 주장이 있으면 두 개의 슬라이드로 나누세요.
  • 고아 슬라이드 없음. 슬라이드 헤드라인을 순서대로만 읽어보세요. 처음부터 끝까지 전체 스토리를 간격 없이 전달해야 합니다.
  • 모든 시각 자료를 정당화하세요. 모든 3D 객체, 차트, Morph 이동은 다음 질문에 답해야 합니다: "청중이 이것이 있기 때문에 무엇을 더 빨리 이해하거나 더 깊이 느끼는가?"

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬