show-dont-tell について
show-dont-tellは、構造化情報をわかりやすく提示するためのエージェントスキルです。内容に応じて表、リスト、ツリー、図、コードブロックを選び、まず結論を示すことを重視します。
主な機能
- 01情報に合った形式の選択
- 02表による選択肢の比較
- 03手順の番号付きリスト化
- 04実行可能な内容のコードブロック化
- 05結論を先に示し根拠を補足
活用シーン
- 01選択肢やパラメーターの比較を整理
- 02順序のある作業手順を説明
- 03ディレクトリ構成、状態遷移、コマンドを提示
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/show-dont-tellを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
プロジェクトの README より清晰呈现结构化信息
选择能帮助读者理解和使用信息的形式。用户指定的格式优先；一两句话即可说清的内容直接回答，因果解释和观点论证用自然段落。
| 内容 | 可选形式 |
|---|---|
| 多个选项、参数或属性需要按相同维度比较 | 表格 |
| 有顺序的操作 | 编号列表，必要时附关键命令 |
| 目录或包含关系 | 树形结构或简短列表 |
| 流程、调用关系、状态转换 | 环境支持时使用 Mermaid |
| 可复制执行的代码、命令或配置 | 标明语言的代码块 |
先表达结论，再给支撑它的结构和必要说明。表格不适合承载长段落；短命令可以内联。图示不能代替缺失的数据或证据，也不应强制使用额外工具。
若需要交互探索或正式导出的图表，使用目标环境中适用的可视化工具；静态信息不必升级为交互产物。不要假定所有客户端都能渲染 Mermaid，必要时提供等价文字。
不需要每次回复都运行格式清单，也不向全局 AGENTS.md 注入本技能。完成时以内容正确、结构便于阅读且符合用户格式要求为准。
コメント
Markdown 対応