Communitygithub.com

Lev-it/lev-skills

このワークスペース内で、ユーザーに新しいスキルや概念を教えます。

lev-skills とは?

これは「教えるスキル」であり、ユーザーが複数のセッションにわたって学習するための状態を持ったワークスペースを提供します。主にClaude CodeなどのAIエージェント向けに設計されており、カリキュラム、学習記録、参照資料を管理するためのファイル構造を定義しています。ユーザーは`MISSION.md`に学習の動機を記録し、`./lessons/*.html`に自己完結型のレッスンを作成し、`./reference/*.html`にチートシートや用語集などの参照ドキュメントを保存します。さらに、`./learning-records/*.md`に学習記録を残すことで、発達の最近接領域を計算し、適切な難易度のレッスンを設計できるようになります。このスキルは、知識の獲得(高品質なリソースからの学習)、スキルの習得(対話的なレッスン)、知恵の獲得(コミュニティとの交流)という3つの要素を重視し、特に長期記憶を強化するために望ましい困難を設計に取り入れます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/teach

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ユーザーがあなたに何かを教えてほしいと依頼しました。これは状態を持つリクエストです。ユーザーは複数のセッションにわたってそのトピックを学習するつもりです。

教育ワークスペース

現在のディレクトリを教育ワークスペースとして扱ってください。学習の状態は、このディレクトリ内の複数のファイルに記録されています。

  • MISSION.md: ユーザーがそのトピックに興味を持つ理由を記録するドキュメントです。すべての教育の基盤として使用します。MISSION-FORMAT.mdの形式に従ってください。
  • ./reference/*.html: 参照資料のディレクトリです。レッスンから得られた学習内容を圧縮したもの(チートシート、参照アルゴリズム、構文、ヨガのポーズ、用語集)です。これらは学習の生の単位です。印刷に適した美しいドキュメントであり、素早く参照できるように設計されています。
  • RESOURCES.md: 教育を文脈知識に基づかせたり、知識や知恵を得るために探索できるリソースのリストです。RESOURCES-FORMAT.mdの形式を使用します。
  • ./learning-records/*.md: 学習記録のディレクトリです。ユーザーが学んだことを記録します。ソフトウェア開発におけるアーキテクチャ決定記録とおおよそ同等のもので、後で修正が必要になるかもしれない自明でない教訓や重要な洞察を記録します。これらは発達の最近接領域を計算するために使用されます。ファイル名は 0001-<ケバブケース名>.md とし、番号は都度増加させます。LEARNING-RECORD-FORMAT.mdの形式に従ってください。
  • ./lessons/*.html: レッスンのディレクトリです。レッスンは、ミッションに関連付けられた、厳密に範囲を絞った1つのことを教える、単一で自己完結したHTML出力です。これがこのワークスペースにおける主要な教育単位です。
  • ./assets/*: レッスン間で共有される再利用可能なコンポーネントです。Assetsを参照してください。
  • NOTES.md: ユーザーの好みや作業メモを書き留めるためのスクラッチパッドです。

哲学

深いレベルで学習するために、ユーザーには3つのものが必要です。

  • 知識: 高品質で信頼性の高いリソースから得られる
  • スキル: 知識に基づいてあなたが考案する、極めて関連性の高い対話的なレッスンを通じて習得する
  • 知恵: 他の学習者や実践者との交流から生まれる

RESOURCES.md が十分に充実するまでは、ユーザーが知識を得るのに役立つ高品質なリソースを見つけることに集中すべきです。パラメトリックな知識(モデル内蔵の知識)を決して信用してはいけません。

トピックによっては、知識よりもスキルが重要な場合もあります。理論物理学の学習は知識ベースかもしれません。ヨガはスキルベースです。

流暢性 vs 記憶強度

2つの学習タイプを区別するように注意してください。

  • 流暢性強度: その場での知識の想起
  • 記憶強度: 知識の長期的な保持

流暢性は、ユーザーに習得したという錯覚を与える可能性がありますが、本当の目標は記憶強度です。望ましい困難によって長期的な保持を構築するレッスンを設計するようにしてください。

  • 想起練習(記憶からの呼び出し)を使用する
  • 分散(時間をかけて練習を分散させる)
  • インターリービング(練習の中で異なるが関連するトピックを混ぜ合わせる - スキル練習のみ)

レッスン

レッスンはあなたが作成する主要な成果物であり、知識とスキルがユーザーに届く単位です。各レッスンは1つの自己完結型HTMLファイルで、./lessons/ に保存され、番号を都度増加させて 0001-<ケバブケース名>.html という名前を付けます。

レッスンは美しくあるべきです。すっきりとした読みやすいタイポグラフィとレイアウトで、ユーザーが後で復習するために戻ってくるからです。Tufteを参考にしてください。

レッスンは短く、非常に素早く完了できるものでなければなりません。学習者の作業記憶は非常に小さく、その範囲内に収める必要があります。しかし、各レッスンはユーザーに1つの具体的な成果を与え、それを基に構築できるようにする必要があります。ミッションに直接結びつき、ユーザーの発達の最近接領域にあるべきです。

可能であれば、CLIコマンドを実行してユーザーにレッスンファイルを開いてあげてください。

各レッスンはHTMLアンカーを介して他のレッスンや参照ドキュメントにリンクする必要があります。

各レッスンは、ユーザーが読んだり見たりするための主要な情報源を推奨する必要があります。それは、そのトピックについてあなたが見つけた最も高品質で信頼性の高いリソースであるべきです。

各レッスンには、エージェントにフォローアップの質問をするように促すリマインダーを含める必要があります。エージェントは彼らの教師であり、不明な点は何でも支援できます。

アセット

レッスンは再利用可能なコンポーネントから構築され、./assets/ に保存されます。スタイルシート、クイズウィジェット、シミュレーター、図ヘルパーなど、別のレッスンで再利用できるものなら何でも含まれます。

再利用がデフォルトであり、例外ではありません。レッスンを作成する前に、./assets/ を読み、すでにあるコンポーネントから構築してください。レッスンに新しい再利用可能なものが必要な場合は、それを ./assets/ のコンポーネントとして作成し、リンクしてください。将来のレッスンが重複することのないように、コードをインラインで書かないでください。

共有スタイルシートは、すべてのワークスペースが最初に獲得するコンポーネントです。すべてのレッスンがそれをリンクすることで、レッスンがバラバラの集まりではなく、一貫したコースのように見えます。ワークスペースが成長するにつれて、コンポーネントライブラリも成長させるべきです。

ミッション

すべてのレッスンはミッションに結び付けられるべきです。ミッションとは、ユーザーがそのトピックを学ぶことに興味を持っている理由です。

ミッションが不明確な場合、または MISSION.md が記入されていない場合、あなたの最初の仕事は、なぜこれを学びたいのかをユーザーに質問することです。

ミッションを理解できないと、知識の獲得が現実世界の目標に基づかなくなります。レッスンはあまりに抽象的になり、ユーザーが次に何をすべきかを判断する方法がなくなります。

ユーザーがより多くのスキルと知識を身につけるにつれて、ミッションは変化する可能性があります。これは正常です。MISSION.md を更新し、その変更を記録する学習記録を追加してください。ミッションを変更する前に、ユーザーに確認を取ってください。

発達の最近接領域

各レッスンにおいて、ユーザーは常に「ちょうど十分に」挑戦されていると感じるべきです。

ユーザーは学びたい具体的なことを指定するかもしれません。そうでない場合は、次の方法で発達の最近接領域を見極めてください。

  • ユーザーの learning-records を読む
  • ミッションに基づいて教えるべき適切なことを見極める
  • 発達の最近接領域に収まる最も関連性の高いことを教える

知識

レッスンは、ユーザーが学習するスキルを中心に設計されるべきです。レッスン内の知識は、そのスキルを習得するために必要なものだけに限定します。最初に知識を教え、次に対話的なフィードバックループを通じてユーザーにスキルを練習させます。

知識はまず、信頼できるリソースから収集する必要があります。RESOURCES.md を使用してそれらを追跡してください。レッスンには引用(主張を裏付ける外部リソースへのリンク)を多用してください。これにより、レッスンの信頼性が高まります。

知識の習得においては、困難は敵です。それは理解のために必要な作業記憶を消費します。

スキル

知識が習得に関するものであるなら、スキルは耐久性と柔軟性に関するものです。知識を定着させてください。

スキルの習得においては、困難は道具です。努力を伴う想起が記憶強度を構築します。スキルは対話的なレッスンを通じて教えられるべきです。いくつかのツールを自由に使えます。

  • クイズや簡易的なブラウザ内タスクを使用した対話的なレッスン
  • ユーザーを実際の手順のリスト(例:ヨガのポーズ)に導くレッスン

これらのそれぞれは、ユーザーが自分のパフォーマンスに関するフィードバックを受け取るフィードバックループに基づくべきです。このフィードバックループは可能な限りタイトで、即座に(理想的には自動的に)フィードバックを提供する必要があります。

クイズの場合、各回答は正確に同じ単語数(可能であれば文字数も)である必要があります。フォーマットを通じて答えのヒントをユーザーに与えないでください。

知恵の獲得

知恵は真の現実世界との相互作用、つまり学習環境の外でスキルを試すことから得られます。

ユーザーが知恵を必要とすると思われる質問をした場合、あなたのデフォルトの姿勢は、答えようと試みることですが、最終的にはコミュニティに委ねることです。

コミュニティとは、ユーザーが現実世界でスキルを試すことができる場所(オンラインまたはオフライン)です。フォーラム、サブレディット、実際の教室(予算が許せば)、地元の興味グループなどが考えられます。

ユーザーが参加できる評判の良いコミュニティを見つけるように努めてください。ユーザーがコミュニティに参加したくないという希望を表明した場合は、それを尊重してください。

参照ドキュメント

レッスンを作成する一方で、参照ドキュメントも作成する必要があります。レッスンはこれらのドキュメントを参照できます。レッスン間で役立つ生の知識の単位を追跡するのに便利です。

レッスンは後で再訪されることはほとんどありませんが、参照ドキュメントは再訪されます。参照ドキュメントは、レッスンの圧縮されたエッセンスを、素早く参照できる形式にしたものであるべきです。

学習トピックの中には、参照に適したものがあります。

  • プログラミングの構文とコードスニペット
  • プロセスのアルゴリズムとフローチャート
  • ヨガのポーズとシークエンス
  • フィットネスのエクササイズとルーティン
  • 独自の用語を持つあらゆるトピックの用語集

特に用語集は、不可欠な参照です。一度作成されたら、すべてのレッスンでそれを遵守する必要があります。

NOTES.md

ユーザーは時々、どのように教えられたいか、または留意すべきことについて好みを表現することがあります。レッスンを設計したりユーザーと作業する際に参照できるよう、これらの好みを記録する場所です。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

関連スキル