# スキルの効果を伝えるための改訂

2026-10-15の追加依頼。作例中心の見せ方を、GitHubスキルの機能・用途・具体的な効果を比較できる構成へ改める。

## 完了条件

同じ版に対してKimi K3とClaude Opus 5.5がそれぞれ100/100と評価するまで、修正と再評価を続ける。

1. 原典のスキルが何を改善するかを正しく伝える。35点。
2. 作例がそのスキルの特徴を実際に使い、具体的なページで効果を確認できる。35点。
3. 実際のスライドが読みやすく、サイト上で効果と利用方法を理解できる。30点。

評価は指定AIによる判断で、人間の利用テストとは区別する。評価対象の版・参照した原典・目視した作例・未確認部分を記録する。未確認を満点とみなさず、基準を緩めて点数を合わせない。

## 情報の順序

改善したい問題、スキルがすること、必要な入力と出力、作例で使った機能、該当ページの見る場所、自分の資料へ適用する手順を示す。作例の題材名と画像はスキルの効果を示すために使う。

原典の機能と、この環境で実際に試した範囲を分ける。原典で必須の入力や特徴を省いた作例は、その不足を明らかにして修復する。冗長な説明やポエム的なコピーを使わない。

## 正本

- 原典と制作方式：`data/repository-guides.json`、各作例の固定原典とPROVENANCE。
- 機能と作例の対応：`data/skill-effects.json`。
- 掲載対象：`data/product-collection.json`。
- 作例：`data/case-studies.json`。

生のモデル実行ログ・私的な評価指示・認証情報は公開しない。公開可能な評価要約は、実行結果と版を照合した後に記録する。公開反映はローカルの修正・評価と分ける。