visuals plugin · 사용 결과

md-to-scrolldeck 사용 결과

마크다운 문서 한 개를 리더 보고용 세로 스크롤스냅 HTML 덱으로 압축합니다. 핵심은 마크업이 아니라 편집적 압축 — 제목을 1:1로 옮기지 않고, 무엇을 자를지 결정합니다.

마크다운 문서
.md
제목이 있는 평범한 문서
md-to-scrolldeck
/visuals:md-to-scrolldeck
5~20개 내러티브 비트로 압축
세로 스크롤 덱
.html
단일 파일, 인쇄 대응
1

실행한 명령

범용 형식:

/visuals:md-to-scrolldeck <마크다운-문서-경로> [--out <경로>] [--slides n] [--outline-only]

이번 예시:

/visuals:md-to-scrolldeck README.md --out docs/skill-output/md-to-scrolldeck-deck.html --no-open
2

입력 (마크다운 문서)

  • 입력 파일: README.md — 이 저장소의 README (177줄)
  • 어떤 마크다운 문서든 입력으로 넣을 수 있습니다. 이번에는 저장소 자신의 README 를 "리더에게 보고하는 문서" 로 보고 덱으로 만들었습니다.
  • 입력 문서는 절대 수정되지 않습니다. 한 번에 한 파일만 처리합니다.
3

중간 산출물 (슬라이드 아웃라인)

이 스킬은 HTML 을 쓰기 전에 먼저 아웃라인을 출력합니다. 여기서 무엇이 살아남고 무엇이 잘렸는지 확인하고 개입할 수 있습니다. 이것이 스킬의 핵심 품질 장치입니다.

# id 라벨 phase 출처
1hero보여줄 수 있는 것으로 만드는 세 스킬INTROL1-6
2three-skills세 개의 산출물, 세 개의 스킬WHATL8-14
3pick-rule주제가 아니라 산출물로 고른다WHATL16-18
4install여섯 하네스, 한 줄 설치INSTALLL29-72
5support-matrix어디까지 되는가HOWL74-86
6image-readback이미지를 되읽지 못하는 하네스라면HOWL88-95
7layout-flat매니페스트는 루트, 스킬은 평평하게HOWL97-118
8layout-why중첩 레이아웃을 버린 이유HOWL120-128
9ci-selfcontained공유 워크플로우를 쓰지 않는다HOWL130-145
10ci-gate되돌아가기 위한 단 하나의 조건NEXTL147-153
11provenance이 스킬들은 어디서 왔는가NEXTL155-173
12closeMIT, 그리고 시작하기STARTL175-177

잘라낸 것

  • GitHub Pages 링크 목록 (L20-27) — 링크 덤프는 슬라이드가 되지 않습니다.
  • 하네스별 설치 코드블록 7개 — 슬라이드 4의 카드 그리드 하나로 병합.
  • .kimi-plugin 사전 프로비저닝 각주 — 슬라이드 8에 흡수.

177줄 문서에서 제목 개수만큼이 아니라 12개 슬라이드가 나온 이유가 이것입니다. 제목은 저자가 화제를 바꾼 지점이고, 슬라이드는 청중이 생각을 바꿔야 하는 지점입니다.

4

결과 (스크롤 덱)

단일 HTML 파일이며, 별도 의존성 없이 브라우저에서 바로 열립니다.

docs/skill-output/md-to-scrolldeck-deck.html
12
슬라이드 = 도트 12개
11
스크롤 큐, 모두 다음 슬라이드로 연결
0
금지 항목 위반

포함된 덱 크롬

  • 상단 진행바 · 고정 헤더(01 / 12 카운터) · 우측 도트 레일
  • 방향키 내비게이션 (PageUp/PageDown/Home/End/Space 포함)
  • scroll-snap-type: y mandatory 와 IntersectionObserver 활성 슬라이드 추적
  • 인쇄 시 스냅 해제 + 슬라이드당 한 페이지, JS 없이도 전체 내용 노출
  • 작성 후 체크리스트 검증 통과 — 테마 토글 · 햄버거 메뉴 · PNG 내보내기 · base64 폰트 0건

문서를 요약하는 것이 아니라, 무엇을 버릴지 결정해서 이야기로 만드는 것이 md-to-scrolldeck 스킬의 역할입니다.