codekongdev · Nov 5, 2026 · Nov 5, 2026 · Nov 5, 2026 · Nov 5, 2026 · Nov 5, 2026
diff --git a/README.ja.md b/README.ja.md
@@ -132,6 +132,7 @@ cp -R plz/skills/plz-3d-explain ~/.claude/skills/plz-3d-explain
 | --- | --- | --- |
 | [plz-3d-explain](skills/plz-3d-explain/README.md) | 技術的な概念やシステム構成を three.js の 3D モデルで学べる、単一 HTML ファイルの学習ページ。 | [コードサンドボックス（英語）](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) · [韓国語](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) |
 | [plz-setup-issues](skills/plz-setup-issues/README.md) | GitHub リポジトリの Issue ラベル、バグ・機能リクエストフォーム、トリアージ規則を設定します。 | — |
+| [plz-quiz](skills/plz-quiz/README.md) | 資料にもとづくクイズで学習し、理解度を確認して間違いを復習します。 | — |
 
 ## コントリビュート
 

diff --git a/README.ko.md b/README.ko.md
@@ -132,6 +132,7 @@ cp -R plz/skills/plz-3d-explain ~/.claude/skills/plz-3d-explain
 | --- | --- | --- |
 | [plz-3d-explain](skills/plz-3d-explain/README.md) | 기술 개념과 시스템 구조를 three.js 3D 모형으로 공부하는 단일 HTML 학습 페이지를 만듭니다. | [코드 샌드박스(한국어)](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) · [영어](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) |
 | [plz-setup-issues](skills/plz-setup-issues/README.md) | GitHub 저장소의 이슈 라벨, 버그·기능 요청 양식, 검토 규칙을 세팅합니다. | — |
+| [plz-quiz](skills/plz-quiz/README.md) | 문서 기반 퀴즈로 공부하고 이해도를 확인하며 오답을 복습합니다. | — |
 
 ## 기여
 

diff --git a/README.md b/README.md
@@ -132,6 +132,7 @@ Details are in the [skill README](skills/plz-3d-explain/README.md).
 | --- | --- | --- |
 | [plz-3d-explain](skills/plz-3d-explain/README.md) | A single HTML learning page with three.js 3D models of technical concepts and system structures. | [Code sandbox (English)](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) · [Korean](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) |
 | [plz-setup-issues](skills/plz-setup-issues/README.md) | Issue labels, bug and feature forms, and triage rules for a GitHub repository. | — |
+| [plz-quiz](skills/plz-quiz/README.md) | Document-based quizzes for studying, checking understanding, and reviewing mistakes. | — |
 
 ## Contributing
 

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -132,6 +132,7 @@ cp -R plz/skills/plz-3d-explain ~/.claude/skills/plz-3d-explain
 | --- | --- | --- |
 | [plz-3d-explain](skills/plz-3d-explain/README.md) | 用 three.js 3D 模型讲解技术概念和系统结构的单文件 HTML 学习页面。 | [代码沙箱（英语）](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) · [韩语](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) |
 | [plz-setup-issues](skills/plz-setup-issues/README.md) | 设置 GitHub 仓库的议题标签、缺陷与功能请求表单和分诊规则。 | — |
+| [plz-quiz](skills/plz-quiz/README.md) | 根据资料生成测验，用于学习、检查理解程度和复习错题。 | — |
 
 ## 参与贡献
 

diff --git a/scripts/check-quiz-template.test.mjs b/scripts/check-quiz-template.test.mjs
diff --git a/skills/plz-quiz/README.ja.md b/skills/plz-quiz/README.ja.md
@@ -0,0 +1,67 @@
+# plz-quiz
+[English](README.md) | [한국어](README.ko.md) | 日本語 | [简体中文](README.zh-CN.md)
+
+自分の資料をもとにしたクイズで学習したり、正解を見る前に理解度を確認したりできます。Claude Code と Codex に対応し、[plz](../../README.md) に含まれるスキルです。
+
+## インストール
+
+以下のコマンドは、このスキルがリポジトリで公開された後に利用できます。ローカルの草案を試すには、エージェントに `skills/plz-quiz/SKILL.md` を直接読むよう依頼してください。
+
+グローバルにインストール:
+
+```sh
+npx skills add codekongdev/plz --skill plz-quiz -g
+```
+
+Codex では `-a codex` を付けます。以下のコマンドは現在のプロジェクトの `.agents/skills/` にインストールします。
+
+```sh
+npx skills add codekongdev/plz --skill plz-quiz -a codex
+```
+
+## 使い方
+
+資料を渡すかノートを貼り付けて、使いたい言語でクイズを依頼してください。
+
+Claude Code:
+
+```text
+/plz-quiz Quiz me on these notes, one question at a time.
+```
+
+Codex:
+
+```text
+$plz-quiz Quiz me on these notes, one question at a time.
+```
+
+依頼の例:
+
+- 「この PDF の第 2 章から選択式の問題を 10 問作って。」
+- 「この資料を理解できているか確認して。解き終わるまで正解は見せないで。」
+- 「用語の暗記より、概念を実際の場面に応用する問題を出して。」
+- 「間違えた概念について、別の問題を出して。」
+
+## 学習・理解度確認モード
+
+- **学習:** 1 問ずつ答えてから、判定、短い解説、資料の根拠を確認します。必要ならヒントを求められます。
+- **理解度確認:** 解答の提出を終えてから、点数、正解、解説を確認します。未回答の問題は採点前に確認し、「わからない」は明示的な回答として扱います。
+
+指定がなければ、学習モード、5 問、選択式・正誤式・短答式の混合、中程度の難易度で始めます。短い資料では問題数を減らし、その理由を伝えます。範囲、問題数、難易度、形式、モード、出力形式は変更できます。
+
+短答式は、表現の完全一致ではなく意味にもとづいて判定します。終了時に問題ごとの結果と復習すべき概念をまとめます。その概念を問う新しい問題で復習を続けられます。
+
+## Web クイズのテンプレート
+
+標準は引き続き対話形式です。Web クイズ用の [HTML テンプレート](assets/quiz-template.html) はビルド不要で、オフラインで動作します。エージェントが先に資料を読み、埋め込まれた問題と UI 文言を差し替えます。ブラウザで PDF をアップロードして読み取る機能はありません。付属の例は、このリポジトリの[貢献ガイド](../../CONTRIBUTING.md)にもとづいています。変更方法は[テンプレートのデータガイド](references/template-api.md)、視覚・操作・アクセシビリティの基準は [Web クイズのデザインガイド](references/web-quiz-design.md)を参照してください。デザインガイドには `frontend-design` と `ui-ux-pro-max` の原則をまとめており、両スキルを別途インストールする必要はありません。
+
+テンプレートは両モードに対応し、選択式・正誤式は自動採点、短答式は参考解答と比較して自己確認する形式です。短答式を AI が採点したようには表示しません。間違えた概念は別の問題で復習し、最初の結果は保持します。データはページを開いている間だけメモリに保持され、永続保存や外部サービスは使いません。
+
+## 資料と制約
+
+- 読み取れる文書、PDF、Markdown、Web ページ、ノート、貼り付けたテキストのうち、指定した範囲を使います。解説では、実際に確認できた文書名、節、ページなどの位置を示します。
+- 出題と採点は資料にもとづきます。出典の位置を作り上げたり、資料にない内容を外部の知識で補ったりしません。
+- 資料の読み取りは、エージェントが利用できるツールに依存します。スキャンした PDF には OCR が必要な場合があります。資料を読めない場合は、読み取れる資料やテキストを求めます。
+- 標準は対話形式です。継続的な学習記録の保存や試験の認定は含まれません。スキル専用の API キーやランタイムは不要です。
+
+手順は [SKILL.md](SKILL.md) を参照してください。
diff --git a/skills/plz-quiz/README.ko.md b/skills/plz-quiz/README.ko.md
@@ -0,0 +1,67 @@
+# plz-quiz
+[English](README.md) | 한국어 | [日本語](README.ja.md) | [简体中文](README.zh-CN.md)
+
+내 문서로 만든 퀴즈를 풀면서 공부하거나, 정답을 보기 전에 학습한 내용을 확인합니다. Claude Code와 Codex에서 사용할 수 있으며, [plz](../../README.md)에 포함된 스킬입니다.
+
+## 설치
+
+아래 명령은 이 스킬이 저장소에 공개된 뒤 사용할 수 있습니다. 로컬 초안을 써 보려면 에이전트에게 `skills/plz-quiz/SKILL.md`를 직접 읽도록 요청하세요.
+
+전역으로 설치:
+
+```sh
+npx skills add codekongdev/plz --skill plz-quiz -g
+```
+
+Codex에서 쓰려면 `-a codex`를 붙입니다. 아래 명령은 현재 프로젝트의 `.agents/skills/`에 설치합니다.
+
+```sh
+npx skills add codekongdev/plz --skill plz-quiz -a codex
+```
+
+## 사용법
+
+문서를 제공하거나 노트를 붙여 넣은 뒤, 원하는 언어로 퀴즈를 요청하세요.
+
+Claude Code:
+
+```text
+/plz-quiz Quiz me on these notes, one question at a time.
+```
+
+Codex:
+
+```text
+$plz-quiz Quiz me on these notes, one question at a time.
+```
+
+요청 예시:
+
+- “이 PDF 2장으로 객관식 문제 10개 만들어 줘.”
+- “이 문서를 이해했는지 확인해 줘. 다 풀기 전에는 정답을 보여 주지 마.”
+- “용어 암기보다 개념을 실제 상황에 적용하는 문제로 내 줘.”
+- “틀린 개념만 다른 문제로 다시 내 줘.”
+
+## 학습·학습 확인 모드
+
+- **학습:** 한 문제씩 답한 뒤 채점 결과, 짧은 해설, 문서 근거를 확인합니다. 필요하면 힌트를 요청할 수 있습니다.
+- **학습 확인:** 답안 제출을 마친 뒤 점수, 정답, 해설을 확인합니다. 빠진 답이 있으면 채점 전에 확인하며, “모르겠어”는 명시적으로 제출한 응답으로 처리합니다.
+
+별도로 지정하지 않으면 학습 모드, 5문항, 객관식·OX·단답형 혼합, 보통 난이도로 시작합니다. 짧은 자료로 충분한 문제를 만들 수 없다면 문항 수를 줄이고 이유를 안내합니다. 범위, 문항 수, 난이도, 유형, 모드, 출력 형식을 바꿀 수 있습니다.
+
+단답형은 표현이 정확히 같은지보다 핵심 의미가 맞는지로 판단합니다. 풀이가 끝나면 문항별 결과와 다시 공부할 개념을 정리합니다. 해당 개념을 묻는 새 문제로 복습을 이어갈 수 있습니다.
+
+## 웹 퀴즈 템플릿
+
+기본은 대화형으로 유지합니다. 웹 퀴즈용 [HTML 템플릿](assets/quiz-template.html)은 빌드 없이 오프라인에서 실행됩니다. 에이전트가 먼저 자료를 읽고 내장된 문제와 UI 문구를 교체하며, 브라우저에서 PDF를 업로드해 읽는 기능은 없습니다. 기본 예시는 이 저장소의 [기여 가이드](../../CONTRIBUTING.md)를 바탕으로 만들었습니다. 교체 방법은 [템플릿 데이터 가이드](references/template-api.md), 시각·상호작용·접근성 기준은 [웹 퀴즈 디자인 가이드](references/web-quiz-design.md)를 참고하세요. 디자인 가이드는 `frontend-design`과 `ui-ux-pro-max`의 원칙을 정리한 것으로 두 스킬을 따로 설치할 필요는 없습니다.
+
+템플릿은 두 모드를 지원하며 객관식·OX는 자동 채점하고, 단답형은 참고 답안과 비교해 직접 확인하도록 표시합니다. 단답형을 AI가 채점한 것으로 안내하지 않습니다. 틀린 개념은 후속 문제로 복습하되 초기 결과를 보존합니다. 데이터는 페이지를 열어 둔 동안 메모리에만 유지하며, 영구 저장이나 외부 서비스는 사용하지 않습니다.
+
+## 자료와 제약
+
+- 읽을 수 있는 문서, PDF, Markdown, 웹 문서, 노트, 붙여 넣은 텍스트 중 지정한 범위를 사용합니다. 해설에는 실제로 확인한 문서명·절·페이지 등의 위치를 표시합니다.
+- 출제와 채점은 자료에 근거합니다. 출처 위치를 꾸며 내거나 자료에 없는 내용을 외부 지식으로 채워 넣지 않습니다.
+- 자료를 읽는 기능은 에이전트가 사용할 수 있는 도구에 따라 달라집니다. 스캔 PDF는 OCR이 필요할 수 있습니다. 자료를 읽을 수 없으면 읽을 수 있는 자료나 텍스트를 요청합니다.
+- 기본은 대화형입니다. 영구 학습 기록과 시험 인증은 포함되지 않습니다. 스킬 전용 API 키나 런타임은 필요하지 않습니다.
+
+진행 절차는 [SKILL.md](SKILL.md)를 참고하세요.
diff --git a/skills/plz-quiz/README.md b/skills/plz-quiz/README.md
@@ -0,0 +1,67 @@
+# plz-quiz
+English | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md)
+
+Study with quizzes based on your documents, or check what you have learned before seeing the answers. Works with Claude Code and Codex. Part of [plz](../../README.md).
+
+## Install
+
+The commands below require this skill to be published in the repository. To try a local draft, ask your agent to read `skills/plz-quiz/SKILL.md` directly.
+
+Install globally:
+
+```sh
+npx skills add codekongdev/plz --skill plz-quiz -g
+```
+
+For Codex, add `-a codex`. This installs into the current project's `.agents/skills/` directory:
+
+```sh
+npx skills add codekongdev/plz --skill plz-quiz -a codex
+```
+
+## Usage
+
+Provide a document or paste your notes, then ask for a quiz in your language.
+
+Claude Code:
+
+```text
+/plz-quiz Quiz me on these notes, one question at a time.
+```
+
+Codex:
+
+```text
+$plz-quiz Quiz me on these notes, one question at a time.
+```
+
+Example requests:
+
+- “Make ten multiple-choice questions from chapter 2 of this PDF.”
+- “Check whether I understand this document. Hide the answers until I finish.”
+- “Ask questions about applying the concepts, rather than just recalling terms.”
+- “Give me new questions about the concepts I got wrong.”
+
+## Study and check modes
+
+- **Study:** answer one question at a time, then see the result, a short explanation, and the source passage. Ask for a hint if you need one.
+- **Check:** submit your answers before seeing scores, correct answers, or explanations. Missing answers are collected before grading; “I don't know” is an explicit response.
+
+Unless you specify otherwise, a session uses study mode, five questions, a mix of multiple-choice, true/false, and short-answer questions, and medium difficulty. A short source may support fewer questions; the agent explains any reduction. You can change the scope, number, difficulty, types, mode, or requested format.
+
+Short answers are assessed by meaning, rather than exact wording. At the end, you receive a question-by-question result and a review of concepts to revisit. You can continue with new questions focused on those concepts.
+
+## Web quiz template
+
+Conversation remains the default. For a web quiz, the [HTML template](assets/quiz-template.html) runs offline without a build step. The agent reads your material first, then replaces the embedded questions and UI labels; the browser has no PDF upload parser. The shipped example is based on this repository's [contribution guide](../../CONTRIBUTING.md). See the [template data guide](references/template-api.md) for customization and the [web quiz design guide](references/web-quiz-design.md) for visual, interaction, and accessibility criteria drawn from `frontend-design` and `ui-ux-pro-max`. Neither skill needs to be installed separately.
+
+The template supports both modes, automatically scores multiple-choice and true/false questions, and lets learners compare short answers with reference answers and check them themselves. Short answers are not AI-graded. Follow-up questions revisit missed concepts while preserving the initial result. Data stays in memory for the open page; there is no persistent storage or external service.
+
+## Sources and limits
+
+- Uses readable documents, PDFs, Markdown, web pages, notes, and pasted text within your chosen scope. Explanations cite real document names, sections, pages, or other available locations.
+- Questions and grading stay grounded in the material. The agent does not invent source locations or silently fill gaps with outside facts.
+- Source reading depends on the tools available to your agent. Scanned PDFs may need OCR. If material cannot be read, the agent asks for a readable source or text.
+- Conversation is the default format. Persistent progress tracking and exam certification are not included. No dedicated API key or runtime is required by the skill.
+
+See [SKILL.md](SKILL.md) for the workflow.