Communitygithub.com

study-site

講義ページ、章ノート、試験対策、コース学習インデックスなどを作成する際に使用します。スライド、PDF、過去問、チュートリアルシート、あるいはトピック名だけからでも構いません。

study-site とは?

Study Site は、インタラクティブな単一ファイルHTML学習ページを構築するためのAIエージェントスキルです。スライド、PDF、過去問、チュートリアルシートなどの資料から、講義ノートや試験対策ページ、コース学習インデックスを自動生成します。スキルはまず質問ラウンドでコースの有無や掲載場所を確認し、添付ファイルをすべて読み込んでトピックごとに整理。各トピックは「説明 → 図 → 図の説明 → 例題 → 過去問 → 練習問題」の順で構成され、試験重要項目や誤解しやすいポイントは専用のコールアウトでマークされます。ページはテンプレートから生成され、ダークテーマ切り替え、進捗トラッキング、検索、モバイル対応、模擬試験モード(コースページのみ)などの機能を標準装備。Cline、Claude Code、Cursor、GitHub Copilot、Codex などのAIエージェンツールで動作し、アーティファクトとして公開するか、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回の質問ラウンド)

リクエストから既に明らかでないことだけを質問します:

  1. これはコース用ですか? はいの場合:どのコース、どのチャプターまたはまとまりですか。コースページには標準機能に加えて試験モードと復習ツールが追加されます。コース以外のページ(一般的なトピック、単発の解説)ではこれらはスキップされます。
  2. どこに掲載しますか? マスターインデックスに直接、コース学習インデックス内(どのインデックス?)、またはどこにも掲載しない。マスターインデックス設定が none の場合はこの質問をスキップします。
  3. コースの学習インデックスURLが不明な場合は質問してください — ページの戻りリンクに必要です。

ユーザーがコースの教え方に関するメモ(記憶、プロジェクト指示、以前のメッセージ)を保存している場合は、それを読み、以下のデフォルトよりも優先して従ってください。

2. 構築前に資料を収集する

  • 添付されたすべてのファイルを完全に読む:スライド、ノート、過去問、チュートリアルシート。
  • 各トピックに属する過去問(PYQ)とチュートリアル問題を収集する。
  • ソース資料のエラーは黙って修正し、指摘しない限り指摘しない。
  • その後にトピックリストを計画する:論理的なトピックごとに1つの <section class="topic">、1回の学習で終えられる小さな単位とする。

3. 教授ルール(全科目共通)

  • 事前知識を前提としない。基本から構築し、すべての用語を初出時に定義し、圧縮するよりも詳しく説明する。
  • 各トピック内の順序:説明 → その直後に図 → 図の説明 → 例題 → PYQ/チュートリアル問題 → 練習MCQ。 図を最後にまとめない。
  • すべての図に説明をつける。裸の図を出荷しない。
  • 試験重要ポイントは .callout.imp、よくある間違いは .callout.mistake でマークする。
  • 問題: すべての問題を完全に書き出してから解答を記載し、決して省略しない。すべての問題に解答する。未回答のままにしない。PYQには出典、年、配点をタグ付けする(例:PYQ 2024 Midsem · 5M)。
  • トピックごとに少なくとも3問の練習MCQを作成し、もっともらしいディストラクター(誤答選択肢)と .why による解説をつける。
  • 図はインラインSVGとし、ASCIIでは作成しない。段階的に変化するものには .stepper(figure.fig.step を状態ごとに1つ)を使用する。
  • 学習スケジュールや日次計画は、要求されない限り作成しない。

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)公式、定義、キー図の1ページサマリー;10枚以上のフラッシュカード
コースページのみ: 試験モード「開始」までぼかし;タイマー;提出時にMCQ採点;模範解答を表示MCQs(data-marks)とコースの過去問スタイルの長文問題を混在;data-minutes を設定

進捗とスコアは閲覧者のブラウザに保存され、ページごとです — インデックスページはチャプターの進捗を表示できず、デバイス間で同期もされません。

6. デザインルール

  • ミニマルで落ち着いたデザイン。長文読書用にセリフ体の本文、UIにはサンセリフ体。コンテンツ幅は約820px。
  • AIスラッジ(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で選択した通りに、マスターインデックスまたはコースインデックスにページリンクを追加する。インデックスを再設計しない。

関連スキル