skills-development について
skills-developmentは、このリポジトリでSKILL.mdを書くための原則集です。変更される可能性のある定義を重複させず、ツールとパラメーターの情報はMCPサーバーから取得するよう定めています。
主な機能
- 01ツール説明の重複回避
- 02呼び出し時の最新スキーマ取得
- 03文章内でのツール名・パラメーター名の回避
活用シーン
- 01リポジトリ内のスキルファイルの作成・改訂
- 02スキルのガイダンスと最新MCPツールの整合
MCP 対応
必要なときに、MCPサーバーからツールの説明とパラメーター定義を直接取得するようエージェントに指示します。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ miroapp/ miro-ai --skill skills-developmentインストール後、Claude Code で/skills-developmentを入力して読み込まれたか確認します。
詳細
スキルの開発
このリポジトリで SKILL.md ファイルを作成する際の原則:
- パラメーターの定義やツールの説明を重複させないでください。 重複した内容は実際のツールとのずれや矛盾を招き、正常に動作する機能からエージェントを遠ざけます。
- エージェントは、呼び出し時に MCP サーバーから直接パラメーターの定義とツールの説明を取得する必要があります。
- 特定のツール名、プレフィックス、サフィックスを記載しないでください。 エージェントは MCP ツール一覧からそれらを見つけます。
- 特定のパラメーター名も記載しないでください。 コードのような名前(
item_id、board_id)を導入するのではなく、「ボード項目の ID」「画像リソースの ID」のように、値を文章で説明してください。パラメーター名もツール名と同様に変わる可能性があるため、エージェントは実際の MCP スキーマを参照する必要があります。
コメント
Markdown 対応