tutor-setup

tutor-setup skill の概要

tutor-setup skill でできること

tutor-setup は、学習資料やコードベースを Obsidian StudyVault に変換します。単なる要約ではなく、構造化された学習ワークスペースを作りたい人向けに設計されており、ノートの作成、ソース素材の抽出、実践向けの整理までまとめて行えます。

どんな人に向いているか

PDF、Webページ、テキストファイル、またはソースリポジトリを、学習やオンボーディングに使える vault に繰り返し変換したいなら、tutor-setup skill が適しています。とくに、自習者、講師、そして一度きりの回答ではなく軽量なナレッジベースを作りたいチームに向いています。

何が違うのか

最大の価値は、モードを意識したセットアップにあります。tutor-setup は、現在のフォルダがドキュメントソースなのかコードプロジェクトなのかを自動判定し、それに合わせてワークフローを切り替えます。Skill Scaffolding としての tutor-setup は、2つの代表的な入力形式を、毎回手作業でプロセスを書き換えずに扱いたいときに便利です。

tutor-setup skill の使い方

正しくインストールしてファイルを配置する

まず skill 環境から install command を実行し、その後は現在の作業ディレクトリの中で作業してください。tutor-setup は CWD の境界を厳密に守るためです。tutor-setup の install flow は、ソースファイルが先に作業フォルダへコピーされていることを前提にしています。その境界の外へ出て取りに行くことはありません。

適切な種類の入力を与える

tutor-setup の使い方はシンプルです。ローカルのソースパスか URL を指定し、あとは skill にモード判定を任せます。よりよい結果を得るには、欲しい成果を明確に伝えてください。たとえば、「この講義ノートから、章ごとの要約と練習問題付きの Obsidian StudyVault を作ってください」や、「この repo から新規開発者向けの onboarding vault を作ってください」といった形です。

最初に読むべきファイル

まずは SKILL.md を読みます。モード判定ルール、CWD 境界、2つのワークフローがここで定義されているからです。コピーに含まれているなら、references/templates.md と skill からリンクされている補助ノートも確認し、出力を求める前に想定される vault 構造を把握してください。repo の文脈では、README.md、AGENTS.md、そして存在する場合は rules/、resources/、references/、scripts/ フォルダも確認しておくとよいです。

出力品質を変えるプロンプトの工夫

ソースの種類、対象読者、深さを最初に明示してください。たとえば「このフォルダに tutor-setup を使う」だけでは解釈の余地が大きすぎます。より強いプロンプトは、その vault を何に最適化したいか、たとえば試験対策、オンボーディング、素早い復習などをはっきり伝えます。Skill Scaffolding として tutor-setup を使う場合は、ほしい出力の形、ノートの粒度、用語・トーン・ファイル名に関する制約も含めてください。

tutor-setup skill の FAQ

tutor-setup は通常のプロンプトより優れているか？

はい。再現性のあるワークフロー、より明確な境界、モード選択が必要なときは、とくに有効です。通常のプロンプトでも内容の要約はできますが、tutor-setup には文書探索、ソースの扱い、vault 作成のための、より明示的なプロセスがあります。

tutor-setup を使わないほうがよいのはどんなときか？

ソースファイルが現在の作業ディレクトリの外にあり、先にコピーしてこれない場合は使わないでください。また、短い答えだけが欲しい場合にも向きません。これは、skill が素早い説明ではなく、構造化された StudyVault を作るためのものだからです。

tutor-setup は初心者にも使いやすいか？

はい、フォルダを指定して、欲しい学習成果を説明できるなら使えます。初心者にありがちなリスクは、入力があいまいすぎることです。学習ノート、練習問題、開発者向け onboarding vault のどれが欲しいのかを明示すると、うまく動きやすくなります。

tutor-setup は docs と code の両方で使えるか？

はい。そこがこの skill の大きな強みのひとつです。tutor-setup は CWD の中身から Document Mode か Codebase Mode かを自動判定します。フォルダが曖昧な場合は、プロンプトでモードを明示して、ワークフローが意図に合うようにしてください。

tutor-setup skill を改善するには

より整理されたソース素材を渡す

tutor-setup の出力が最もよくなるのは、範囲が絞られた入力です。単一のフォルダ、明確なソースセット、分類しやすいファイルを用意してください。素材が散らかっていたり、混在していたり、重複していると、その混乱が vault にもそのまま引き継がれやすくなります。

ソースだけでなく、最終用途も指定する

tutor-setup に、vault を何に使うのかを伝えてください。試験復習、概念の定着、チームのオンボーディング、プロジェクト立ち上げなどです。その選択によって、ノートで重視される内容、詳しく扱うべきセクション、練習問題の切り口が変わります。

最初の vault でモード判定ミスを確認する

よくある失敗は、モードの選択ミス、または構成が一般的すぎることです。最初の結果に違和感があるなら、ソースの種類を明示し、モードを確認し、重要なフォルダや文書を指定したうえで、修正版を求めるようにプロンプトを絞り込んでください。

具体的な制約を足して反復する

tutor-setup をよりうまく使うには、すべてやり直すのではなく、具体的な修正を求めるのが有効です。たとえば、「ノートの深さを抑える」「練習問題を増やす」「オンボーディング用語に焦点を当てる」「密度の高いトピックを小さな学習ノートに分割する」といった指示です。こうした調整なら、skill がすでに作った構造を保ちながら、出力を意図に合わせられます。