microsoft/skills-for-copilot-studio

A skill for AI-coding tools to build and edit Microsoft Copilot Studio agents as YAML — with schema validation, templates, and AI-powered skills. Suited for Claude Code, GitHub Copilot CLI, and more.

Skills for Copilot Studio – 概要

Skills for Copilot Studio は、Microsoft Copilot Studio エージェントをコマンドラインまたは VS Code から直接操作できるプラグインです。次の 4 つのサブコマンドが追加されます。

管理 – エージェントのソースファイルをローカルマシンと Copilot Studio クラウド間で管理（クローン、プル、プッシュ、同期）します。
作成 – ガイド付きの AI 支援フローを使用して、エージェントの YAML 定義（トピック、アクション、ナレッジ、トリガー、変数）を作成します。
テスト – 公開済みエージェントをポイントテスト、バッチスイート、評価分析でテストします。
アドバイス – 専門の「アドバイザー」サブエージェントから設計ガイダンス、レビュー、トラブルシューティングを受けます。

このプラグインは 3 つのフロントエンドで動作します。

Claude Code（Anthropic の Claude 用 CLI）
GitHub Copilot CLI
VS Code（Copilot Studio 拡張機能経由）

これは実験的な研究プロジェクトであり、公式にサポートされている Microsoft 製品ではありません。基盤となる YAML スキーマは変更される可能性があります。

クイックスタートワークフロー

# 1. クラウドから既存のエージェントをクローン（サインインページが開きます）
/copilot-studio:copilot-studio-manage clone

# 2. 新しいトピックを作成（例: IT サービスリクエストの処理）
/copilot-studio:copilot-studio-author Create a topic that handles IT service requests

# 3. ローカルコピーを同期
/copilot-studio:copilot-studio-manage pull
/copilot-studio:copilot-studio-manage push

# 4. 公開済みエージェントをテスト
/copilot-studio:copilot-studio-test Send "How do I request a new laptop?" to the published agent

# 5. アドバイザーに設計フィードバックを依頼
/copilot-studio:copilot-studio-advisor Review my agent for improvements and known pitfalls

完全なエンドツーエンドガイドは SETUP_GUIDE.md にあります。

インストールオプション

インターフェース	インストール方法
Claude Code CLI	`/plugin marketplace add microsoft/skills-for-copilot-studio && /plugin install copilot-studio@skills-for-copilot-studio`
GitHub Copilot CLI	VS Code 拡張機能ストアで Skills for Copilot Studio を `@agentPlugins` フィルターで検索し、インストールをクリックします。
VS Code	リポジトリをローカルにクローンし、`claude --plugin-dir <path>` で読み込むか、`claude plugin install <path> --scope user`（または `project`）で永続的にインストールします。

更新はホストプラットフォームに従います。Claude Code では自動更新、Copilot CLI では手動の plugin update、VS Code では通常の拡張機能更新メカニズムです。

対象ユーザー

ターミナルファーストのワークフローを好む Copilot Studio 開発者。
「標準」エージェント（YAML ベースのエージェントタイプ）を構築し、迅速な同期、テスト、設計アドバイスを必要とする チーム。
エディターや CLI を離れずにプロトタイプを作成したい 実験者。

注意事項

このプラグインは実験的です。YAML スキーマは予告なく変更される可能性があります。
AI が生成した YAML は、本番環境にプッシュする前に必ずレビューしてください。
公式にサポートされている Microsoft 製品ではありません。

貢献

ビルド手順、テスト実行、プルリクエストの提出については CONTRIBUTING.md を参照してください。