ベストプラクティス

Claude のために、簡潔で信頼性の高い Agent Skills を書く。

Agent Skills specification · Claude documentation

First-party guide reviewed against current official references. It is not a full official-documentation translation.

The navigation uses English labels. Article languages are shown separately; the interface is not a full translation of the documentation.

Source text is documentation. These workflows have not been executed or tested by this site.

On this page

これは ClaudeSkills 独自のガイドです。2026-10-04 に以下の資料と照合しました。公式ドキュメントの全文翻訳ではありません。

起動条件を具体的にする

作業と利用状況を説明します。起動すべき例と、似ていても起動すべきでない依頼を比較します。

入力、手順、完了条件を示します。詳しい資料は別ファイルに置き直接リンクします。停止、情報の確認、出力の検査が必要な時点を説明します。

公開仕様では name と description が必須です。名前はフォルダと一致し、小文字、数字、ハイフンを使い最大 64 文字です。説明は空にせず最大 1024 文字です。compatibility と license は要件の明確化に役立ちます。

代表的な入力を使い成果物を確認します。曖昧な依頼、欠けたファイル、起動しない作業も含めます。未検証のソースを合格済みと表示しないでください。