How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/kulikala/wakariyasu --skill explain-clearlyBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
スキルの目的
ユーザーが分からなかったものを、ユーザーが分かる言葉で言い直す。中身は変えず、伝え方を変える。
分からなかった点の特定
言い直す前に、ユーザーが引っかかったものを判断する。
- 語(「〜とは?」): 作業の中で使い続けた呼び名や、ツールの出力に出てきた語であることが多い。
- つながり(「どういうこと?」): 1つずつの文は読めても、何が何の理由なのか、何と何を比べているのかが追えていない。
- 結論(「つまり?」): 説明は読めたが、自分にとって何を意味するのか、何を判断すればよいのかが分からない。
- 違い(「〜と〜の違いは?」): 並んだものの、どこが違い、選ぶと何が変わるのかが分からない。
- 全体(「分かりやすく」): 上のどれか1つに絞れない。直前の返答を、経緯を知らない人の視点で頭から読み、引っかかる箇所をすべて挙げる。
ユーザーの言葉から上のどれに当たるかを判断できないときは、直前の返答から、ユーザーがセッションの中で使っていない語と、何を示すかが語を含む文の中に記載されていない語を探し、探した語から言い直す。
説明の長さの選択
| 言われた言葉 | 向き |
|---|---|
| 「つまり?」「簡潔に」「一言で」 | 短くする。結論を1〜3文で言い、必要な条件だけを残す |
| 「どういうこと?」「小学生でも分かるように」「平易に」 | 前提を足す。結論の前に、知らないと読めない前提を短く置く |
| 「言い換えると?」「分かりやすく」 | 長さは大きく変えない。語と文の組み立てを替える |
| 「〜とは?」 | 語の意味を1〜2文で言い、今の話の中で何を示しているかを添える |
| 「〜と〜の違いは?」 | 違う点だけを並べる。選ぶと何が起きるかまで記載する |
表に無い言い方は、意味の近い行として扱う。
言い直しの方法
- 結論を先に述べる。
- 作業の中で付けた呼び名・略称・ファイルの中の語は、ユーザーが使った言葉か、一般に通じる言葉に置き換える。正確さが必要な固有名(ファイル名・コマンド名)は残し、何のためのものかを添える。
- 元の説明に無い因果やつながりを足さない。別々に決定した2つのことを、理由を示す接続でつながない。つながりが分からなければ、別々の文で記述する。
- 例えを使うなら1つだけにし、例えのどこが本題のどこに当たるかを記載する。
- 前の説明で記載した条件・例外・確かさ(推定か、確かめたか)を、短くするために落とさない。落とすなら、落としたことを記載する。
- 言い直し自体から始める。前の説明のどこが分かりにくかったかの説明や、謝りの前置きは要らない。
書き方は規則「ユーザーへの返答は、経緯を追っていない人が読んで分かるように記述する」(スキル writing-rules の rules/writing-to-user.md)に従う。
送信前の確認
- 言い直した文を、直前の返答を読んでいない人の視点で、頭から順に読む。前に戻って読み直した箇所があれば修正する。
- 規則「記述した文章は、渡す前に整える」(スキル
writing-rulesのrules/polishing.md)に沿って整える。表記で迷ったら、「日本語の表記の選び方」(スキルwriting-rulesのreferences/styles.md)を読む。