writing-skills目的、用途、および情報源

このスキルが何をするか

新しいスキルを作成するとき、既存のスキルを編集するとき、または展開前にスキルが正しく動作するかを確認するときに使用します。

上流ワークフローの仕組み

skills/
  skill-name/
    SKILL.md              # Main reference (required)
    supporting-file.*     # Only if needed

要件とセットアップ

制限事項と品質チェック

このファイルからは、個別の制限に関する記述は選択されていません。これは、このスキルがあらゆる入力や環境において安全であることを意味するものではありません。ソースコード全体を確認し、ご自身で結果を検証してください。

まずは安全なトライアルから始めましょう

1. サポートされているホストとリポジトリのインストール手順を確認してください。スキルディレクトリと、それに関連付けられているスクリプト、アセット、ドキュメントはまとめて保管してください。SKILL.md単独では依存関係を省略できる場合があります。
2. エージェントに実際の入力、希望する出力、および受け入れ基準を指定してください。呼び出し構文と利用可能なツールはホストによって異なります。このサイトは、汎用的なインストールコマンドを前提としていません。
3. 使い捨てプロジェクトまたはコピーで、元のワークフローを試してみてください。ファイル、リモートサービス、または課金対象リソースを変更する操作は、許可する前に必ず確認してください。
4. 出力結果をソースの品質チェックおよび独自の要件と照らし合わせて検証してください。トリガーが成功したことやリポジトリのスター数が多いことだけでは、正しい結果とは言えません。

スキルフォーマットとディレクトリの仕様 ↗

詳細は出典元をご覧ください。

• 概要
• スキルとは何か？
• スキルに関するTDDマッピング
• スキルを作成するタイミング
• 技術
• パターン
• 参照
• ディレクトリ構造
• 書き込みSKILL.md
• フローチャート
• コード例
• 自己完結型スキル
• 再利用可能なツールのスキル
• 多用参考資料​​を用いたスキル
• 鉄則（TDDと同じ）
• すべてのスキルタイプをテストする
• 規律を強制するスキル（rules/requirements）
• テクニック・スキル（ハウツーガイド）
• パターン認識能力（メンタルモデル）
• 参考スキル（documentation/APIs）
• テストを省略する際の一般的な正当化理由
• フォームと失敗を一致させる
• 合理化に対する防弾対策
• スキル向けRED-GREEN-REFACTOR
• 赤色：書き込み失敗テスト（ベースライン）
• 緑：最小限のスキルで書く
• リファクター：抜け穴を塞ぐ
• マイクロテストの文言（フルシナリオの前に）
• ❌ 物語の例
• ❌ 多言語希釈

関連スキル

• brainstormingobra/superpowers
• diagnosing-superpowersobra/superpowers
• dispatching-parallel-agentsobra/superpowers
• executing-plansobra/superpowers

翻訳と範囲

この読書ガイドは、ピン留めされた上流からの抜粋を選りすぐっていますSKILL.md翻訳は補助的なものです。完全なマニュアルではなく、互換性テスト済みであることを保証するものでもありません。ご使用前に原文および参照ファイルをお読みください。

この紹介文は、下記に固定表示されているバージョンに関するものです。現在のリポジトリのアクティビティと収集時間は別途表示されます。

ピン留めされたソース

原文を読む ↗

ソースを取得しました

2026-10-29T09:32:23Z

ソースコミット

2ce8aa15d05bd57213e6f746f953aafb7ded7a8b

ソースSHA-256

8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe