skill-source-citations について
スキルの作成・編集で参照した資料を記録する Skill Steward 向けガイドです。スキルの作成者やレビュー担当者が、会話だけでなく各スキルの references に出典リンクを残せるようにします。
主な機能
- 01スキルごとの sources.md 管理
- 02調査前後の出典リンク記録
- 03明白でない主張へのインラインリンク
- 04PR での出典更新リマインダー
- 05引用対象の指針
活用シーン
- 01スキル作成時の参照資料記録
- 02PR 内の手順に関する主張の確認
- 03会話をまたいだ調査リンクの保存
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/skill-source-citationsを入力して読み込まれたか確認します。
同梱ファイルreferences/citation-template.mdreferences/sources.md
詳細
スキルの出典引用
ルール： ドキュメント、論文、他のリポジトリ、チャットでの調査から得た知識は、会話に残すだけでなく、スキルツリー内にリンクとして保存してください。
使用する場面
skills/{name}/SKILL.mdを新規作成または編集するとき- スキルを作成する前に、ハーネス／MCP／マーケットプレイスのパターンを調査するとき
- 出典のない手順に関する主張を追加する PR をレビューするとき
スキルごとのファイル（skill_steward で必須）
次を管理してください：skills/{name}/references/sources.md
# Sources
| Topic | URL | Used for |
|-------|-----|----------|
| Agent Skills spec | https://agentskills.io/ | Frontmatter rules |
| … | … | … |
## Changelog
- 2026-05-29: initial citations
テンプレート：citation-template.md。
ワークフロー（スキルの新規作成または更新）
- 執筆前 — 参照する URL を
references/sources.mdに記載します（最初は最小限でもかまいません）。 - SKILL.md 内 — 自明でない内容には仕様書／ドキュメントへのリンクをインラインで追加し、長い資料には
references/を使用します。 - 調査後 — 新しい行と変更履歴の項目を追記します。「X を読んだ」とチャットに書くだけで終わらせないでください。
- PR 内 — 説明に「
references/sources.mdの出典を更新しました。」と一行記載します。 - 検証 —
pnpm run validateはsources.mdがない場合に警告します。
引用するもの
| 引用対象 | 例 |
|---|---|
| 公式仕様 | agentskills.io、Cursor／Claude／Codex のドキュメント |
| 論文／調査 | SkillOpt、SkillsBench arXiv |
| リファレンス実装 | 製品の MCP、Codex plugin-eval |
| ブログ／ガイド | 手順が自明でない場合のみ。一次資料を優先してください |
一時的なチャット URL やプライベートトークンは引用しないでください。
スキル横断インデックス
ギルド全体のリファレンス：docs/STANDARDS.mdx、DESIGN_FAQ.mdx。
関連スキル
| タスク | スキル |
|---|---|
| スキルのひな形作成 | skill-authoring-lifecycle |
| 評価／改善 | skill-eval-improve |
| 仕様の監査 | skill-authoring-lifecycle |
出典管理（このスキル）
references/sources.md を参照してください。
インストール
npx skills add arenukvern/skill_steward --skill skill-source-citations
コメント
Markdown 対応