Communitygithub.com

report-presentation

기술 보고서, 논문, 프로젝트를 발표용 슬라이드 데크와 대본으로 변환하거나 기존 슬라이드와 대본을 검토 및 개선하며, 리허설, 발표, Q&A 준비를 지원합니다. AsciiDoctor-reveal.js(AsciiDoc) 또는 LaTeX Beamer + PlantUML 다이어그램 형태의 데크를 제작하고, 데크 통계 스크립트로 점검합니다.

report-presentation란 무엇인가요?

이 스킬은 기술 보고서, 논문, 프로젝트 결과물을 효과적인 발표(토크)와 슬라이드 데크로 변환하거나, 기존 슬라이드와 발표 대본을 검토·개선하고, 리허설, 실제 발표, Q&A 세션을 준비하는 작업을 체계적으로 돕습니다. 논문 심사(디펜스), 프로젝트 상태 보고, 컨퍼런스 발표, 3~10분 분량의 짧은 발언 등 다양한 상황에 대응합니다. AsciiDoctor-reveal.js(AsciiDoc) 또는 LaTeX Beamer 형식으로 슬라이드 데크를 생성하며, PlantUML 다이어그램과 발표자 노트를 포함하고, `deck_stats.py` 스크립트로 슬라이드 적합성을 점검합니다. 사용자가 '슬라이드 만들어 줘', '데크 검토해 줘', 'N분에 맞게 발표를 조정해 줘' 등과 같은 요청을 할 때 이 스킬을 호출하면 됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/larsw/report-writing-skills/tree/HEAD/skills/report-presentation

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

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

문서

기술 발표

발표는 보고서를 그대로 읽는 것이 아니라, 새롭게 창조하는 작업입니다. 보고서는 머리에 도달하지만, 발표는 가슴에도 도달합니다. 독자는 자신의 속도와 거리(30~40cm)를 선택할 수 있지만, 청중은 각 슬라이드를 몇 초 동안, 10m 거리에서 보면서 동시에 듣습니다. 몇 달간의 작업을 20분에 담을 수는 없습니다. 발표는 각 청중이 따라가며 기억할 수 있는, 잘 선택된 '열쇠 구멍으로 들여다보기'를 제공합니다.

방법론은 H. Hering(K.-G. Heyne 공저), How to Write Technical and Scientific Reports(3판, Springer 2025) 5장을 따릅니다.

어떤 작업인지 결정하세요:

  • 생성: 보고서/자료로 발표/데크 만들기 → 1~5절
  • 검토: 기존 데크 또는 대본 검토 → 6절
  • 리허설, 발표, 질문 답변 → references/delivery.md
  • 짧은 발언(3~10분, 종종 준비되지 않은 슬라이드) → references/delivery.md의 '짧은 발언' 참조

1. 프레임워크와 목표 (먼저 기록하세요)

사용자가 제공한 내용을 바탕으로 references/talk-planning.md의 프레임워크 시트를 작성하세요. 발표 내용을 바꾸는 항목에 대해서만 질문하세요:

  • 주제 및 발표 제목(보고서 제목보다 짧고 기억에 남으며 정확해야 함)
  • 청중: 누구인지, 사전 지식, 관심사, 기대치, 결정권자
  • 행사 및 정확한 시간 슬롯(질의응답 포함/제외)
  • 유형: 강의(정보 전달), 기술 발표(정보 전달 및 설득), 설득형 발표, 기념사
  • 가중치가 있는 목표(예: 결과에 대해 70% 정보 전달, 능력 20% 입증, 편안함과 유머 10%) 및 그 배경 목적(학점, 자금 지원, 의사 결정, 후속 프로젝트)
  • 장소, 미디어, 원격/하이브리드 설정; 이전 및 다음 발표자
  • 기밀 사항: 외부 발표 전에 지도교수, 상사, 고객(그리고 회사의 마케팅 부서)에게 명확히 공개

2. 자료 선별

이 청중과 목표에 필수적이고 의미 있으며 대표적인 것만 남기세요. 나머지는 예비 자료(백업 슬라이드, 'CAN' 노트)로 분류하여 여유 시간과 질문에 대비하세요. 발표자 본인에게만 흥미로운 모든 여담은 제거하세요.

3. 발표 구조 만들기

보고서의 장(chapter) 구성에서 벗어나 청중의 입장을 취하세요. 극적인 구성을 가진 몇 개의 짧고 기억에 남는 항목을 만드세요:

  • 서두는 긴장을 조성하는 내용(질문, 구체적인 결과를 초래하는 문제, 인상적인 예시)으로 열고, 이를 해결하며 마무리하세요.
  • 20분 발표의 경우 시간 분할은 서론 약 20% / 본론 70% / 결론 10%(4/14/2분). 60분의 경우 서론과 결론은 비례보다 덜 늘어납니다(8/48/4).
  • 혼합 청중을 위한 본론(3분할 규칙), 엄격한 블록이 아닌 상호 혼합 구조: 잘 알려진 예제와 개요(약 1/3) → 대부분이 따라올 수 있는 수준의 새로운 통찰(약 1/6) → 전문가 세부 사항(약 1/3), 자주 일반 수준으로 복귀 → 모두가 이해할 수 있는 종합, 결론, 평가(약 1/6). 아무도 '다 아는 내용이었다'거나 '너무 어려웠다'고 느껴서는 안 됩니다.
  • 서론: 접촉, 발표 목표, 진행 순서(구조 슬라이드), 범위 한정(다루지 않을 내용).
  • 결론: 핵심 결과 요약, 간단한 전망, 새로운 내용 없음, 명확한 종료.

이 내용을 구조 설계 도표(템플릿은 references/talk-planning.md에 있음)에 각 부분별 소요 시간(분)과 함께 기록하세요. 135페이지 보고서가 하나의 서두 질문, 세 개의 하위 항목으로 구성된 하나의 본론 항목, 그리고 결론으로 바뀔 수 있습니다.

4. 슬라이드

슬라이드를 작성하기 전에 references/slide-design.md를 읽으세요. 핵심 사항:

  • "적을수록 좋다." 슬라이드당 5~7개 요소; 키워드, 완전한 문장이 아님(최종 요약 슬라이드는 짧은 문장을 사용할 수 있음).
  • 각 제목은 슬라이드의 메시지를 구어체로 진술("통합 흡입 장치가 연기의 90%를 제거합니다")하고, 현재 구조 항목과 명확하게 연결되어야 함.
  • 쓰지 말고 시각화하세요; 프로젝션용으로 보고서 그림을 재설계: 요소 줄이기, 선 두껍게, 레이블 훨씬 크게. 보고서나 저널의 그림을 변경 없이 그대로 붙여넣지 마세요.
  • 텍스트는 슬라이드 높이의 약 1/30보다 작지 않게(고전 슬라이드 기준 약 18pt); 산세리프체; 슬라이드당 최대 두 가지 글꼴 크기; 색상은 항상 의미를 가지고 드물게 사용; 흰 바탕에 검은색이 가장 가독성 좋음; 색상 텍스트는 크기의 1.5배 필요.
  • 모든 슬라이드에 반복되는 클러터(잡음) 없음: 발표 제목, 이름, 날짜, 'x/y 슬라이드' 카운터, 긴 바닥글. 작은 슬라이드 번호는 괜찮음.
  • 세 가지 프레임워크 슬라이드: 제목 슬라이드; 콘텐츠 키워드가 있는 구조 슬라이드("서론 / 본론 / 요약 / 감사합니다" 아님); 토론을 유도하는 마지막 슬라이드(핵심 이미지, 연락처 정보). "감사합니다"와 "질문 있으신가요?"는 말로 표현하고 슬라이드에 보여주지 않음.
  • 청중의 방향 감각 유지: 전환 시점에 현재 항목을 강조하여 구조를 다시 보여주세요.
  • 애니메이션은 목록이나 프로세스의 단계별 구축에만 사용; 장식적인 움직임이나 소리 없음.
  • 건너뛸 수 있는 슬라이드(예비)는 미리 표시.

5. 데크 만들기 (asciidoctor-reveal.js 또는 Beamer)

사용자가 작업하는 형식을 사용하세요: AsciiDoc 프로젝트에는 asciidoctor-reveal.js, 보고서가 LaTeX이거나 PDF 데크가 필요한 경우 LaTeX Beamer(명확하지 않으면 질문).

  • reveal.js: references/revealjs-asciidoc.md: 슬라이드당 하나의 == 섹션, 모든 콘텐츠 슬라이드에 [.notes] 발표자 노트, 빌드를 위한 [%step], 슬라이드 크기에 맞는 글꼴의 PlantUML 다이어그램, 구조 슬라이드용 하이라이트 클래스가 있는 사용자 정의 CSS.
  • Beamer: references/beamer.md: 메시지 제목이 있는 슬라이드당 하나의 frame, 발표자 노트를 위한 \note{…}, 빌드를 위한 오버레이, 구조 슬라이드를 위한 \AtBeginSection + \tableofcontents[currentsection], 탐색 기호 및 반복되는 하단선 비활성화.

두 형식 모두에서 발표자 노트는 완전한 텍스트가 아닌 키워드로 작성하고, MUST / SHOULD / CAN 태그(반드시 말해야 할 내용, 시간이 부족할 때 생략 가능한 내용, 예비 내용)를 붙이며, 각 구조 항목에 'hh:mm까지 완료' 체크포인트를 추가하세요.

그런 다음 점검하세요:

python3 scripts/deck_stats.py deck.adoc --minutes 20      # 이 스킬의 디렉토리
python3 scripts/deck_stats.py talk.tex --minutes 20       # Beamer: frames, \frametitle, \note, \appendix 이후 백업

이 스크립트는 각 슬라이드의 보이는 단어 수, 요소 수, 노트를 나열하고, 노트에서 예상 발표 시간(기본값 분당 130단어)을 추정하며, 과부하된 슬라이드, 슬라이드 내 문장, 누락된 제목, "감사합니다"/"질문 있으신가요?" 슬라이드, 일반적인 안건 항목, 노트 없는 슬라이드에 플래그를 표시합니다. 계획된 시간이 슬롯 보다 짧아지도록(실제 발표는 노트 제안보다 길어짐) 조정하고, 모든 플래그가 수정되었거나 의도적인 선택(짧고 밀도 높은 전문가 슬라이드는 의도적일 수 있음)이 될 때까지 반복하세요.

결과물: 데크 파일(및 사용자 정의 CSS), 프레임워크 시트 및 구조 설계 도표, 시간 표, 예비 슬라이드 목록. 청취자가 있는 전체 시간 재는 시험 리허설을 권장합니다(references/delivery.md 참조).

6. 기존 데크 또는 대본 검토

  1. 프레임워크 파악: 청중, 슬롯, 목표. 이것 없이 슬라이드 피드백은 추측에 불과합니다.
  2. deck_stats.py 실행(AsciiDoc 또는 Beamer 데크) 또는 슬라이드 텍스트 추출(.pptx/PDF) 후 동일한 항목을 읽으며 세어보세요.
  3. 발표 전체를 점검: 보고서를 그대로 옮긴 것인가, 아니면 새롭게 창조했는가? 서두의 긴장감과 해결된 질문? 20/70/10 시간 분할? 3분할 규칙 혼합(전문가에게 너무 피상적이거나 나머지 청중에게 너무 전문 용어가 많은가)? 이론 먼저, 예제 나중(흔한 실수)? 중간 요약? 예비 자료? 명확한 종료?
  4. 각 슬라이드를 references/slide-design.md와 대조하여 점검.
  5. 심각도별 보고(치명적: 슬롯에 맞지 않음, 잘못된 청중 수준, 메시지 없음; 주요: 슬라이드 과부하 또는 읽을 수 없음, 보고서 그림 변경 없음, 구조 방향성 상실; 사소: 스타일 세부 사항). 각 슬라이드 발견 사항에 대해 슬라이드 번호/제목과 구체적인 재작성 방안(새 제목, 목록 축소, 그림 재설계 설명)을 제시하세요. 발표된 내용에 대한 채점식 평가를 위해서는 references/delivery.md의 검토 양식을 사용하세요.

Individual skills in this repo

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

report-copyedit

Copyedit and line-edit technical and scientific writing (reports, theses, lab reports, papers, specifications, design docs, technical documentation) for clarity, precision, consistent terminology and correct notation, without changing the technical content. Use this whenever someone asks to copyedit, proofread, line-edit, tighten, simplify, polish the language of, improve the readability or flow of, or "fix the English in" a technical text, AsciiDoc, LaTeX or Markdown file; to make terms, units, abbreviations, hyphenation or capitalization consistent; or to build a style sheet from an existing draft. For a whole-document pre-submission review (structure, figures, references, checklist) use report-review instead.

report-drafting

Draft the content of technical and scientific reports - introduction, state of the art, methods/test setup, results, discussion, summary/conclusions, abstract, appendices - together with their figures, tables, PlantUML diagrams, charts, formulas, computations and citations, in AsciiDoc, LaTeX or plain prose. Use this whenever someone asks to write, draft, expand, or turn notes, data, measurements, code or bullet points into a section of a report, thesis, lab report, design report, project report or technical documentation; to create or improve a figure, diagram, chart, caption, table or evaluation/decision matrix for one; to set up equations or a load calculation; or to add citations and a reference list - even if they just say "write up these results".

report-outline

Plan a technical or scientific report before and while drafting it - analyze the assignment, write and test title variants, condense the core message into one sentence, grow a 4-point then 10-point then detailed outline, pick a structure pattern for the report type (lab/test report, design report, project report, thesis, manual, research paper), and set up a style sheet and an AsciiDoc or LaTeX skeleton. Use this whenever someone is starting or reorganizing a report, thesis, lab report, design report, project report or technical documentation and asks for an outline, structure, table of contents, chapter plan, section order, working title or title ideas, or asks "how should I organize this?" - and also to check an existing outline or ToC for logic (lone subsections, unequal siblings, vague headings).

report-review

Review a technical or scientific report, thesis, lab report, design report or technical document as a whole before submission or release - structure and logic, completeness, clarity for a reader without project knowledge, figures and tables, citations and reference list, formulas and notation, terminology consistency, cross-references, open TODO markers and output quality - using a mechanical AsciiDoc/LaTeX linter plus a checklist, and produce a prioritized findings report with concrete fixes. Use this whenever someone asks to review, check, audit, assess, give feedback on, "look over", or do a final/pre-submission/QA pass on a report or thesis (AsciiDoc, LaTeX, Markdown, PDF or Word), asks "is this ready to hand in?", or wants supervisor-style feedback on a draft chapter.

관련 스킬