Book To Skill

예시 체험

고1 통합과학 — 내 탐구 보고서 지도 노트를 다시 쓸 수 있는 스킬로 만들기

꾸민 수업 예시 직접 생성 — 에이전트 제작 새 창에서 크게 보기

선생님이 입력한 내용

고등학교 1학년 통합과학 '자유 탐구' 단원. 교사가 수업에서 반복해 쓰는 '탐구 보고서 지도' 원칙(질문 좁히기, 근거 정리, 다섯 칸 구조, 피드백 순서)을 자체 정리 노트로 모아 두었다. 이 노트를 AI 에이전트가 불러 쓸 수 있는 스킬로 만들어, 보고서 피드백과 자료를 준비할 때 같은 기준으로 도움을 받고 싶은 상황이다.

제가 수업용으로 직접 정리한 '과학 탐구 보고서 지도 안내서'(마크다운 문서)를 제 AI 에이전트가 계속 쓸 수 있는 스킬로 만들어 주세요. 기술 서적이 아니라 줄글 위주 문서이고, 원문 그대로가 아니라 프레임워크와 판단 기준 중심으로 정리해 주세요. 스킬 이름(slug)은 science-inquiry-report-guide 로 하고, 교사 개인용으로 만들어 주세요.

나온 결과

경로 먼저 관점 — 탐구 보고서 지도의 목적은 "결과가 맞았는가"가 아니라 "근거에서 결론까지 가는 길이 이어져 있는가"를 보는 것이다. 질문 좁히기 3단계 — 현상 정하기 → 변인 찾기 → 질문으로 바꾸기. 재는 것이 없는 질문은 탐구가 아니라 조사다. 근거 사다리 — 관찰 → 측정 → 자료 → 해석. 결론은 3단계 이상의 근거를 딛고 서야 한다. 피드백 우선순위 3층 — 1층 구조 → 2층 근거 → 3층 표현. 한 번에 한 층만 피드백한다.

직접 해 보기 — 3단계

1. opencode 같은 AI 에이전트에 저장소 안내대로 이 스킬(book-to-skill)을 설치한다. 문서 경로를 넣으면 문서 종류(줄글/기술서)와 스킬 이름을 물어본다.
2. 바꿀 문서 경로와 원하는 스킬 이름을 적은 문장을 붙여 넣는다. 위 문장을 바꿔 써도 된다. 문서 종류는 '줄글 위주'로 답한다.
3. 만들어진 스킬 폴더(SKILL.md·chapters·glossary·patterns·cheatsheet)를 열어, 장 요약·용어·판단 규칙이 내 문서와 맞는지 확인하고 어긋난 곳은 원문을 고쳐 다시 만들게 한다.

수업 상황은 이해를 돕기 위해 꾸민 예시입니다. 만든 방법: opencode (DeepSeek) + 이 스킬 (book-to-skill) · 확인일 2026-10-16. 이 스킬의 결과물은 그림이 아니라 마크다운 파일 묶음(SKILL.md + 장별 요약 + glossary·patterns·cheatsheet)이다. 위 그림은 스킬이 실제로 낸 파일 내용을 한 장으로 옮겨 보여 준 미리보기이며, 파일 내용은 고치지 않았다. 문서 추출은 이 저장소의 extract.py를 실제로 돌렸고(마크다운 → 내장 텍스트 추출, 감지된 장 5개·868단어), 이후 장 요약과 부속 파일 생성은 저장소의 SKILL.md 절차를 그대로 따라 만들었으며 생성 뒤 스캔(scan_generated_skill.py)도 통과했다. 다만 스킬이 안내하는 '개인 스킬 폴더(~/.agents/skills) 설치' 단계는 하지 않고 임시 폴더에만 썼다. 입력으로 쓴 문서는 이 예시를 위해 쓴 교사의 자체 정리 노트이며 실제 출판된 책이 아니다. 문서 속 예시 숫자(새 잎 8장·4장·1장, 빛을 받는 시간 0·6·12시간 등)는 설명을 위한 수업용 예시 값이고 실제로 측정한 값이 아니다. 스킬은 문서 내용의 사실 여부나 성취기준 적합성을 검증하지 않으므로, 실제 수업에 쓰기 전에 장 요약이 원문과 맞는지, 우리 교육과정 성취기준에 맞는지, 예시 값이 실제 자료와 맞는지 교사가 직접 확인해야 한다. 실제 출판된 책을 넣어 만들면 결과물은 그 책에서 파생된 요약이므로 공개 배포하지 말고 개인용으로만 써야 한다(스킬 자체 규칙).

써 보려면

1. 저장소 virgiliojr94/book-to-skill를 엽니다.
2. 설치가 필요합니다. 절차는 저장소 안내를 따릅니다.
3. 이 기록에는 API 키가 필요하지 않다고 되어 있습니다.

출처

스타 수와 라이선스는 공식 저장소 기준이며, 일일 검증이 다시 확인합니다. 정보 정정 요청

라이선스