본문으로 건너뛰기

코덱스로 강의 준비 자동화: PDF를 실습용 웹 교안으로

한경숙

2026.10.20

코덱스로 강의 준비 자동화: PDF를 실습용 웹 교안으로 본문 이미지

코덱스(Codex)로 PDF를 180분 웹 교안으로 바꿨습니다. 강의 자료를 다시 만들 때 쓸 스킬을 구축한 과정을 정리했습니다.

코덱스를 활용한 강의 준비 자동화

강의 계획서를 구상하고, 대본을 거쳐 HTML 교안까지 만드는 순서를 작업 지침으로 정리했습니다. 이번 작업에서 제가 강조하고 싶은 것은 다음 강의 자료를 만들 때도 다시 쓸 스킬을 구축한 과정입니다.

처음에는 강의 대상, 인원, 시간, 주제를 입력받아 결과물 생성까지 이어지는 흐름을 설계해 달라고 요청했습니다. lecture-prep-orchestrator는 그 제작 순서를 관리하도록 붙인 이름이다. 강의 내용을 한 번 생성하는 작업과 함께, 어떤 순서로 준비하고 확인할지도 정한 것입니다.

처음 보낸 요청의 핵심 문장은 이렇습니다.

위의 프롬프트로 강의 요청 정보(대상, 인원, 시간, 주제 등)를 자동 분석하고 산출물 생성까지 이어지는 전체 프로세스를 개선하기 위해, 맞춤형 오케스트레이터(lecture-prep-orchestrator)를 설계 해줘
(일부)

받은 설계안에는 입력 확인, 대상 분석, 강의계획서, 참고자료 확인, 슬라이드 대본, HTML 제작과 점검, 요청한 배포가 들어갔습니다. 강의 주제가 없으면 확인하고, 인원과 시간이 비어 있으면 기본값을 쓰도록 했습니다. 입력이 부족할 때의 처리도 다음 작업에 가져갈 지침에 포함됐습니다.

재사용 가능한 강의 생성 스킬 구축

HTML을 만드는 부분은 html-lecture-generator 스킬로 따로 구축했습니다. 계획서와 대본을 읽고 학습 내용을 구성한 뒤, 실제 HTML 파일로 저장하고 점검하는 절차입니다. 제가 요청한 기능에는 다크 모드와 실시간 타이머가 들어 있었습니다.

화면과 동작을 HTML 파일 하나에 담는 조건도 처음부터 넣었습니다. 글자와 카드의 모양을 정하는 CSS, 버튼과 타이머를 움직이는 JavaScript를 문서 안에 함께 넣는 방식입니다. 완성된 교안을 열 때 외부 라이브러리를 따로 설치하지 않는 구성을 요청했습니다.

파일로 받은 생성 패키지에는 스킬 지침, 입력 형식 설명, 화면 템플릿, 생성 도구와 검사 도구가 들어 있습니다. 강의마다 달라지는 내용은 계획서와 대본에서 가져오고, 화면 구성과 생성 절차는 다시 쓰도록 묶었습니다. 원문의 순서와 학습목표, 시간, 공개할 내용을 정리해 생성 도구에 전달하는 흐름입니다.

재사용할 때 확인할 항목도 지침에 들어갔습니다. 단원별 시간을 더했을 때 전체 시간과 맞는지, 이미지가 빠지지 않았는지, 기존 파일을 어떻게 보존할지 같은 내용입니다. 메모를 입력할 때 발표용 방향키가 글쓰기를 방해하지 않도록 하는 조건도 구현 과정에서 다뤘습니다.

전체 강의 준비 흐름은 설계안으로 정리했고, HTML 부분은 생성 도구와 템플릿을 포함한 패키지로 받았습니다. 모든 단계를 한 번에 실행하고 배포까지 마치는 과정 전체를 검증한 상태는 아닙니다. 실제로 적용한 결과는 뒤에서 만든 PDF 기반 교안으로 확인했습니다.

캡처와 PDF를 활용한 스킬 적용

원하는 화면은 참고 캡처로 전달했습니다. 흰색 카드, 연한 청회색 배경, 파란 제목, 상단 탭과 색이 다른 시간표가 있는 모습이었습니다. 화면 구성을 설명하는 자료로 이 캡처를 사용했습니다.

위의 캡쳐 사진 스타일을 모방하여 만들어줘

요청 뒤에는 이론, 실습 A, 실습 B, 정리로 이동하는 상단 탭과 카드 형태의 본문이 있는 HTML 샘플을 받았습니다. 타이머와 메모 도구도 유지됐습니다. 같은 스타일을 다음 교안에 적용할 수 있도록 별도 패키지도 만들어졌습니다.

그다음 제페토 빌드잇 강의 PDF를 첨부했습니다.

이 PDF 강의 파일을 대입하여 HTML 교안 만들어줘

PDF 내용은 학습 단원으로 구성됐고, 원문 화면도 교안 안에서 볼 수 있게 들어갔습니다. 최종 파일에는 PDF 1쪽부터 78쪽까지의 화면 이미지가 모두 포함돼 있습니다. 각 페이지를 이미지로 담아 필요한 화면을 펼치고 확대하는 방식입니다.

이 과정에서 같은 생성 흐름에 디자인 참고 자료와 실제 강의 자료를 차례로 적용했습니다. 먼저 만든 샘플의 화면 구조를 바탕으로, 첨부한 PDF의 내용을 가진 교안을 받은 것입니다.

최종 HTML의 전체 시간과 단원별 시간 합계는 모두 180분입니다. 21개 학습 단원의 배정 시간을 더해 확인했고, 화면에 표시하는 시간표에도 같은 값을 반영했습니다.

  • 이론: 20분

  • 실습 A: 100분

  • 실습 B: 40분

  • 정리: 20분

여기서 180분은 완성된 강의의 길이입니다. 교안을 만드는 데 걸린 시간이나 절약한 시간을 뜻하지 않습니다. 이전 작성 방식과 비교할 제작 시간은 따로 측정하지 않았습니다.

코덱스 교안의 주요 기능

완성된 교안에는 내용을 읽는 화면과 수업 진행에 필요한 조작 기능이 함께 들어갔습니다. 상단 탭으로 큰 구간을 이동하고, 단원별 실습을 펼쳐 볼 수 있습니다. 퀴즈는 6개가 포함돼 있습니다.

▲ 코덱스로 만든 제페토 빌드잇 교안의 제목과 180분 시간표

강의 교안 웹 주소: https://zepeto-buildit-180min.vercel.app/

화면은 밝게 또는 어둡게 바꾸고 글자 크기도 조절하도록 만들었습니다. 타이머는 시작, 일시정지, 재설정이 가능하게 구성됐습니다. 발표 모드, 전체 화면, 인쇄 기능도 들어 있다.

학습하면서 남길 정보는 단원 메모와 실습 완료 표시로 나눴습니다. 메모와 완료 상태는 해당 브라우저에 저장하는 방식이며, 메모는 텍스트로 내보내는 기능이 있습니다. 목차 검색으로 필요한 단원을 찾는 기능도 포함됐습니다.

원문 화면은 페이지를 고르거나 앞뒤로 이동하며 볼 수 있습니다. 확대 범위는 50%부터 400%까지입니다. 작은 메뉴 글씨가 있는 PDF 화면을 교안 안에서 크게 볼 수 있게 한 부분입니다.

이미지까지 HTML 안에 넣어 파일 하나로 보관하도록 만들었습니다. 파일 크기는 약 10.4MiB이며, 외부 화면 자료를 불러오는 주소가 없는 것도 확인했습니다. 본문 설명과 원문 화면, 실습 기능을 한 파일 안에 묶은 결과다. 실제 수업 현장에서 수강생과 사용한 결과는 아직 이 글에 포함하지 않았습니다.

다음 강의에서의 개선 사항

다음 자료를 만들 때는 강의 대상, 주제, 총시간과 첨부 자료를 바꿔 같은 제작 순서를 사용할 수 있도록 정리했습니다. 이번에 보낸 요청을 합쳐 다듬으면 아래처럼 시킬 수 있습니다. 실제 요청을 재사용용으로 다듬은 문장입니다.

Open optionsauto

[강의 대상]을 위한 [주제] 강의를 [총시간]분 구성으로 준비해줘.
계획서와 대본을 바탕으로 HTML 교안을 생성하는 스킬을 구축해줘.
첨부한 PDF를 강의 내용에 적용하고, 참고 캡처의 스타일을 반영해줘.
외부 라이브러리 없이 HTML 파일 하나로 저장해줘.
다크 모드, 타이머, 실습을 펼쳐 보는 기능을 넣어줘.

이번 작업에서는 시간의 단위를 다시 요청한 뒤 전체 시간표와 단원별 시간을 함께 맞췄습니다. 다음 교안에서도 총시간을 바꾸면 단원별 배정까지 확인하는 항목을 이어 쓸 수 있습니다. 화면 모양뿐 아니라 내용과 시간을 확인하는 절차도 스킬에 남겼습니다.

Vercel을 통한 파일 배포

HTML 파일 생성은 완료했고, 다른 사람이 웹 주소로 여는 배포는 남아 있습니다. 교안을 받은 뒤 제가 “배포 가능해?”라고 요청해 배포용 파일까지 준비했습니다. 저장소 업로드에 필요한 인증 입력이 환경의 자동 승인 정책에 막혀 결과물은 HTML 교안이었습니다. Vercel로 연결해 공유할 수 있는 공개 주소 인증과 업로드 문제를 해결한 뒤 배포 결과를 확인했습니다.

이번에 남긴 것은 강의 준비 순서를 정리한 설계안, 다시 사용할 HTML 생성 스킬 패키지, 실제 PDF를 적용한 180분 교안입니다. 다음 자료에서도 가져갈 부분은 스킬과 템플릿이고, 이번에 바꿔 넣은 내용은 첨부 PDF와 강의 시간입니다.

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

한경숙 프로필 이미지
한경숙2026.10.22

모두 스터디장님들 잘 인도한 덕분입니다~

야호심 프로필 이미지
야호심2026.10.21

우와 엄청나시네요. 👍 👍
과거 pdf 파일로 진행하던 수업을 이제는 웹으로 진행할 수가 있게 되었네요. 그리고 자료만 준비된다면 원하는 디자인으로 표현할 수 있다는 자신감도 갖게 되신 것 같아요.
정말 큰 변화를 경험하신 것 같아요.
내일 사례 발표에서 이 경험 많이 알려주세요. 😍 😍

뽀짝이 프로필 이미지
뽀짝이2026.10.20

안녕하세요, 한경숙님! PDF 78쪽을 180분짜리 웹 교안으로 바꾸신 과정 잘 읽었어요.

특히 "강의를 한 번 만드는 일"과 "다음 강의에서도 다시 쓸 스킬을 만드는 일"을 구분하신 점이 인상 깊었어요. 단원별 시간(이론 20 · 실습 A 100 · 실습 B 40 · 정리 20)을 더해 180분이 맞는지 확인하는 절차를 스킬에 남기신 것도 재사용할 때 큰 힘이 될 것 같아요.

실제 수업에서 수강생과 써본 결과가 더해지면 후속 글도 기대돼요. 고롱고롱… 좋은 글 덕분에 기분 좋은 아침이에요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기