# Copilot Sdk

> Keep TroubleScout’s GitHub Copilot SDK integration current by verifying the installed Copilot CLI + GitHub.Copilot.SDK versions, updating when needed, and following the official usage guidance. Use when this capability is needed.

- Skill: `tomevault-io/copilot-sdk` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/copilot-sdk`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/copilot-sdk/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/copilot-sdk

---


# Copilot SDK (TroubleScout)

Use this skill when you’re changing anything related to `GitHub.Copilot.SDK` or session/event streaming behavior.

## Always keep components current

This repo depends on two moving parts:

- **GitHub.Copilot.SDK (NuGet)**: the .NET client library used by TroubleScout.
- **GitHub Copilot CLI**: the local CLI the SDK talks to (server mode under the hood).

### Check SDK version (.NET)

- Check for outdated packages:
  - `dotnet list package --outdated`
- If `GitHub.Copilot.SDK` is behind:
  - Update to the latest version and confirm it still builds:
    - `dotnet add package GitHub.Copilot.SDK --version <latest>`
    - `dotnet build`

### Check Copilot CLI version

- Verify the CLI is installed and working:
  - `copilot --version`
- If it’s missing or outdated, follow the official installation/update guide (Windows supports WinGet):
  - https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli

Notes:
- Copilot CLI must be installed separately; the SDK communicates with it.
- If the CLI requires login, complete authentication before debugging SDK behavior.

## Official usage guidance (read these first)

- Copilot SDK repo: https://github.com/github/copilot-sdk
- Getting started guide: https://github.com/github/copilot-sdk/blob/main/docs/getting-started.md
- .NET reference/README: https://github.com/github/copilot-sdk/blob/main/dotnet/README.md
- .NET cookbook: https://github.com/github/copilot-sdk/tree/main/cookbook/dotnet

## Implementation expectations for TroubleScout

- Prefer the SDK’s **event subscription model** (subscribe via `session.On(...)` and treat `SessionIdle` as the completion signal).
- Avoid inventing APIs; validate patterns against the official .NET README.
- After any SDK-related change, run `dotnet build`.

## Troubleshooting checklist

- If sessions don’t start: verify `copilot --version` works and the CLI is authenticated.
- If events don’t stream: confirm session config enables streaming and handlers are subscribed before sending.
- If behavior differs after updates: re-check the official .NET README and the repo release notes, then make the smallest compatible change.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/sasler) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->