own-words

own-words

own-words は、トピックを質問カードのデッキに変換します。カードごとに質問が表示され、回答を入力すると、準備された回答が表示されます。その回答を「わかった」または「もう一度見る」と評価して、次に進みます。

私は ADHD です。準備された回答を先に読むと、いつも理解した気になっていましたが、次の本当の質問で、それが違うとわかりました。先に自分の回答を入力すると記憶に残るので、このデッキは今では、何かを表示する前に入力するようにしています。 New here? Try the 2-minute tutorial.

インストール不要です。試してみましょう

https://alexslkgit.github.io/own-words/

このページには2つのデッキがあります。「How own-words works」は8枚、「Claude Code in 30 questions」は30枚です。どちらかを開いて、3、4枚に回答すれば、全体像がわかります。

自分のデッキを作る

どの方法でもアカウントは不要です。

ランディングページのボックスにデッキのJSONを貼り付けます。フェンス付きの返信や、JSONの前後にチャット文があっても問題ありません。ボックスがその中からデッキを見つけます。

同じページで「Copy the prompt」を押し、プロンプトとトピックをアシスタントに渡して、返ってきた内容を貼り付けます。

Claude Code プラグインをインストールします。

claude plugin marketplace add alexslkgit/own-words
claude plugin install own-words@own-words

次に、トピックまたはファイルを指定して /own-words を実行します。カレントディレクトリに <topic-slug>.deck.json を作成して検証し、そのデッキを開くリンクを表示します。

デッキは1つのJSONファイルです。キー、タイトル、そして質問と回答で構成されるカードのブロックが含まれます。上記の2つのデッキは decks/ にまったく同じ形式で保存されており、この形式で提供される内容以外は何も含まれていません。ファイルを使えば、デッキを別のデバイスに移すこともできます。30枚のデモへのリンクは、デッキ全体を含むため約17 KBあります。長いデッキはファイルとして保存し、短いデッキはリンクで共有してください。

カードには重みを付けることもできます。"w": 1 から 100 までの値を指定します。デッキ内のいずれかのカードに重みが設定されていると、ヘッダーに3つの切り替えが表示され、デッキ全体、重みが60以上のカードのみ、または85以上のカードのみを表示できます。これにより、短い学習でも特に重要な内容を扱えます。重みのないカードは常に表示されます。

回答が難しくて読みづらいとき

回答が表示されたら、理解できない単語をタップするか、フレーズを選択してから「Simpler, not longer」を押します。ページは、回答自体の単語数を上限にしたリクエストを作成します。Claude または任意のチャットに送信し、返答を貼り付けてください。ページは上限を超える単語数の返答を拒否するため、カードの長さを増やさずにわかりやすくできます。プラグインを使うと、Claude Code は元の回答を変更せずに、より簡単なバージョンをその隣の .deck.json に書き込みます。たとえば、「existential」と「witness table」を選択した場合は次のようになります。

変更前、30語：コンパイラが認識しているものの隠されている具体的な型を some が1つ指定します。一方、any は実行時に witness table を介して解決される存在ボックスであるため、その呼び出しは特化できません。

変更後、26語：some：コンパイラが認識している実際の型で、名前が付いていないだけです。any：実行時に開くボックス（一致する任意の型に対応）なので、その呼び出しは特化できません。

デッキの保存場所

リンクにはデッキ全体が URL の #d= の後ろに含まれており、lz-string で圧縮されています。URL フラグメントは HTTP リクエストで送信されないため、デッキのリンクを開いても、サーバーがデッキを保持することはありません。deck.html は渡されたデッキを表示するだけで、それ以外のことは何も知りません。

開いたデッキはすべて、このブラウザーの localStorage に ownwords:decks:<key> と ownwords:index というキーで、回答やマークとともに保存されます。ランディングページの「My decks」に一覧表示されます。アカウントは不要で、入力した内容がサーバーに保存されることもありません。このページのサイトデータを消去すると、デッキと進捗が削除され、「My decks」も空になります。.deck.json ファイルまたはリンクがあればデッキは復元できますが、進捗は復元されません。

テキストが移動するのは、カードページのコピー ボタンを押したときだけです。デッキをプレーンテキストに変換します。テキストには、触れたカードすべての問題、自分の言葉で書いた回答、マークに加えて、手をつけなかったカードの番号が含まれます。ボタンを押すまでは何もコピーされません。このテキストを、デッキを作成したチャットに貼り付けることで、より難しいカードを依頼できます。

プレーンな HTML と JavaScript で、ビルド手順は不要です。依存関係はベンダー提供のものが 1 つ（lz-string）だけです。ページは Google Fonts に 2 種類の書体をリクエストしますが、これをブロックしても、file:// パスから開いた場合を含め、システムフォントで問題なく動作します。

connector/ は小さなリモート MCP サーバーで、claude.ai からデッキのリンクを直接渡せます。公開インスタンスは https://own-words-mcp.alexslkmain.workers.dev/mcp で動作しています。claude.ai で Settings > Connectors > Add custom connector を開き、この URL を貼り付けて、No sign-in を選択してください。状態は保持せず、何も保存しません。デッキはリンクに含まれます。自分で実行する方法は connector/README.md をご覧ください。

アンインストール

claude plugin uninstall own-words@own-words
claude plugin marketplace remove own-words

このサイトでは何もインストールする必要がないため、タブを閉じるだけで十分です。

要件

サイトおよびデッキのリンクを開くには、最新のブラウザーが必要です。プラグインには Claude Code が必要です。

これは、ある個人がバージョン 0.3.0 として作成したツールです。自分のデッキで毎日使っています。英語の文字列は新しく書いたものなので、表現が不自然な箇所があれば、そのためです。

実際に学ぶ必要のある内容で試してみて、自分の回答を先に書くことで、1 週間後の記憶に変化があったでしょうか？Issue を作成して教えてください： https://github.com/alexslkgit/own-words/issues

MIT ライセンスです。LICENSE をご覧ください。