Communitygithub.com

study-site

대화형 단일 파일 HTML 학습 페이지를 구축합니다(아티팩트로 게시하거나 .html 파일로 저장). 슬라이드, PDF, 기출문제, 튜토리얼 시트 또는 주제 이름만으로 강의 페이지, 챕터 노트 페이지, 복습 또는 시험 준비 아티팩트, 코스 학습 인덱스를 만듭니다.

study-site란 무엇인가요?

이 스킬은 강의, 복습, 시험 준비를 위한 대화형 단일 파일 HTML 학습 페이지를 생성합니다. AI 어시스턴트(예: Claude, Codex)가 제공하는 아티팩트 기능이나 .html 파일 저장을 통해 사용됩니다. `assets/template.html` 템플릿을 기반으로 하여 검색, 진행 상황 추적, 테마 토글, 복사 버튼 등 필수 기능이 누락되지 않도록 합니다. 과정별 페이지에는 시험 모드(타이머, 그레이딩)와 복습 도구(치트 시트, 플래시카드)가 포함되며, 비과정 페이지는 단순화된 기능을 제공합니다. 교수 방식은 사용자 메모나 스킬 규칙(주제를 기초부터 설명, 다이어그램 설명, 기출문제 풀이 등)에 따라 조정됩니다. 수학, 이론, 시스템, 언어 등 과목 유형별로 시각적 요소와 문제 풀이 접근법이 자동으로 최적화되어, 개발자나 교육 콘텐츠 제작자가 일관된 고품질 학습 자료를 신속하게 제작할 수 있게 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ranjit-choudhary/claude-skills-ranjit/tree/HEAD/study-site

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

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

문서

Study Site

대화형 단일 파일 HTML 학습 페이지를 구축하여 아티팩트로 게시하거나(아티팩트를 사용할 수 없는 경우 .html 파일로 저장) 만듭니다. 모든 페이지는 assets/template.html에서 시작하므로, 기본 기능이 누락되지 않습니다.

0. 설정 — 직접 수정하세요

설정값
마스터 인덱스 URL (모든 과정을 연결하는 허브)none — 허브 URL을 설정하거나 none으로 두어 인덱스 업데이트를 건너뜁니다
기본 테마light (다크 모드 토글은 항상 포함됨)
챕터 탐색과정 인덱스로 돌아가는 링크만 — 이전/다음 챕터 링크는 없음
인덱스 카드 스타일최소: 아이콘, 과정 코드, 과정 이름 — 통계 없음

1. 먼저 질문 (한 번의 질문 라운드)

요청에서 이미 명확한 내용만 질문하지 마세요:

  1. 과정용인가요? 예인 경우: 어떤 과정, 어떤 챕터 또는 덩어리인지. 과정 페이지는 시험 모드와 복습 도구가 기본 기능 위에 추가됩니다. 과정이 아닌 페이지(일반 주제, 일회성 설명)는 이를 생략합니다.
  2. 어디에 나열해야 하나요? 마스터 인덱스에 직접, 과정 학습 인덱스 내부(어느 인덱스인지), 또는 아무데도 없음. 마스터 인덱스 설정이 none이면 이 질문을 건너뜁니다.
  3. 과정의 학습 인덱스 URL을 모르면 물어보세요 — 페이지의 뒤로 가기 링크에 필요합니다.

사용자가 과정을 어떻게 가르치길 원하는지에 대한 메모(메모리, 프로젝트 지침, 이전 메시지)를 저장했다면, 이를 읽고 아래 기본값보다 우선하여 따르세요.

2. 자료 수집 후 구축

  • 첨부된 모든 파일(슬라이드, 노트, 기출문제, 튜토리얼 시트)을 완전히 읽습니다.
  • 각 주제에 속하는 지난해 기출문제(PYQ)와 튜토리얼 문제를 수집합니다.
  • 소스 자료의 오류를 조용히 수정합니다. 요청하지 않는 한 지적하지 마세요.
  • 그런 다음에만 주제 목록을 계획합니다: 각 논리적 주제에 하나의 <section class="topic">, 한 번에 끝낼 수 있을 만큼 작게.

3. 교수 규칙 (모든 과목)

  • 사전 지식이 없다고 가정합니다. 기초부터 시작하여 모든 용어를 처음 사용 시 정의하고, 압축하기보다 자세히 설명합니다.
  • 각 주제 내 순서: 설명 → 그 직후 다이어그램 → 다이어그램 설명 → 예제 풀이 → PYQs/튜토리얼 문제 → 연습 MCQ. 다이어그램을 끝에 모아 두지 마십시오.
  • 모든 다이어그램에는 설명이 제공됩니다. 빈 다이어그램을 제공하지 마십시오.
  • 시험 중요 포인트는 .callout.imp로, 일반적인 함정은 .callout.mistake로 표시합니다.
  • 문제: 모든 문제를 축약하지 않고 전체를 먼저 쓰고 그 다음 해답을 씁니다. 모든 문제에 답하십시오. 답하지 않은 문제는 남기지 마십시오. PYQ에는 출처, 연도 및 점수를 태그합니다 (예: PYQ 2024 Midsem · 5M).
  • 주제당 최소 3개의 연습 MCQ, 그럴듯한 오답과 .why 설명 포함.
  • 다이어그램은 인라인 SVG입니다. ASCII는 사용하지 않습니다. 단계별로 진화하는 것은 .stepper(각 상태에 하나의 figure.fig.step)를 사용합니다.
  • 요청하지 않는 한 학습 일정이나 일일 계획은 작성하지 않습니다.

4. 과목별 적응

과목 유형중점 사항
이론 / 증명 (계산 이론, 이산 수학, 알고리즘)모든 오토마타에 대한 상태 다이어그램; 입력 문자열을 추적하는 스테퍼; 증명 템플릿(펌핑 보조정리, 환원, 귀납법)을 빈칸 채우기 단계로 제시; 많은 작은 예제
시스템 (운영체제, 컴퓨터 구조, 네트워크)시각 우선; 파이프라인, 스케줄링 간트 차트, 페이지 교체, 캐시 조회를 위한 스테퍼; 단계별로 푸는 수치 문제; 교과서 장 끝 연습 문제
언어 / 형식 표기법 (프로그래밍 언어, 컴파일러)BNF/EBNF, 파스 트리 및 속성 문법을 깨끗한 SVG 트리로; 정규 표현식은 조금씩 구축; 튜토리얼 문제를 인라인으로 풀이
수학 중심 (머신러닝, 통계, 신호)직관 먼저, 그 다음 각 단계가 정당화된 라인별 유도; SVG로 플롯; 풀이된 교과서 연습 문제
서술적 (생물학, 경영, 인문학)기출문제 중심: 주제별로 PYQ 그룹화, 시험 길이의 모범 답안, 프로세스용 순서도 및 비교 표

목록에 없는 과목은 가장 가까운 행을 선택하십시오. 사용자의 과정 노트가 이 표를 재정의합니다.

5. 페이지 기능 (템플릿에 내장)

기능작동 방식당신의 작업
라이트 테마 + 다크 토글기본 라이트; 🌙로 전환; 선택 기억CSS 변수만 사용 — 하드코딩된 색상 없음
스크롤 복원위치 저장 후 다시 열 때 복원없음
진행 추적주제별 "완료로 표시", 진행률 표시줄, 목차에 ✓ 표시각 주제 섹션에 고유 id
검색주제를 필터링하고 일치 항목 강조없음
이미지 복사모든 figure.fig 위에 호버 버튼이 PNG 복사 (터치에서 항상 표시)모든 다이어그램이나 이미지를 figure.fig로 감쌈
모바일 친화적반응형; 테이블은 좌우 스크롤SVG는 viewBox 기반으로 유지; 고정 너비 없음
연습 MCQ즉시 피드백; 답변 기억data-answer = 정답의 0 기반 인덱스
답변 표시details.answer모든 긴 형식 해답에 사용
뒤로 가기 링크헤더가 과정 학습 인덱스로 연결{{COURSE_INDEX_URL}} 채움
과정 페이지 전용: 복습 도구치트 시트(.cheatsheet) + 플래시카드(.flashdeck)공식, 정의, 핵심 다이어그램의 한 페이지 요약; 10개 이상의 플래시카드
과정 페이지 전용: 시험 모드시작 전 블러 처리; 타이머; 제출 시 MCQ 채점; 모범 답안 공개MCQs(data-marks)와 과정의 기출문제 스타일을 따른 긴 문제 혼합; data-minutes 설정

진행 상황과 점수는 뷰어의 브라우저에 페이지별로 저장됩니다. 인덱스 페이지는 챕터 진행 상황을 표시할 수 없으며, 장치 간 동기화되지 않습니다.

6. 디자인 규칙

  • 미니멀하고 차분합니다. 긴 읽기용 Serif 본문, sans-serif UI. 콘텐츠 너비 ~820px.
  • AI 슬롭 방지: 보라색 그라데이션, 히어로 배너, 모든 중앙 정렬 레이아웃, Inter, 이모지 축제 금지.
  • 색상에는 의미가 있습니다: 파랑 = 정보, 금색 = 시험 중요, 빨강 = 오류, 초록 = 정답/완료.
  • SVG 다이어그램: 모든 항목에 레이블; 획과 채우기에 var(--text), var(--accent) 등 사용; 모바일 너비에서 텍스트 ≥12px.

7. 과정 학습 인덱스 페이지

과정 인덱스 또는 허브의 경우: 미니멀 카드(설정 참조), 동일한 헤더(검색 + 테마 토글), 스크롤 복원, 라이트 기본값.

8. 구축, 게시, 확인

  1. assets/template.html을 복사하고 {{placeholders}}를 채운 다음, 과정 페이지가 아닌 경우 과정 전용 블록을 삭제하거나(또는 과정 페이지의 경우 주석 해제).
  2. 아티팩트로 게시(또는 .html 저장). 먼저 보여주고 확인합니다.
  3. 데스크톱과 ~390px 너비, 두 테마 모두에서 확인: 모든 figure에 복사 버튼이 있는지, 모든 MCQ에 올바른 data-answer가 있는지, 모든 질문에 답변이 있는지, {{placeholders}}가 남아 있지 않은지.
  4. 1단계에서 선택한 대로 마스터 인덱스나 과정 인덱스에 페이지 링크를 추가합니다. 인덱스를 재설계하지 마십시오.

관련 스킬