Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "microsoft-events",
"description": "Connect your project to Microsoft Build and Ignite sessions — discover relevant talks, explore what's new for your stack, and plan next steps from your development environment.",
"version": "1.0.6",
"version": "1.0.8",
"author": {
"name": "Microsoft"
},
Expand Down
2 changes: 1 addition & 1 deletion .github/plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "microsoft-events",
"description": "Connect your project to Microsoft Build and Ignite sessions — discover relevant talks, explore what's new for your stack, and plan next steps from your development environment.",
"version": "1.0.6",
"version": "1.0.8",
"author": {
"name": "Microsoft",
"url": "https://www.microsoft.com"
Expand Down
8 changes: 4 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ This repo packages the **Microsoft Events** assistant plugin and the `@microsoft
The repo publishes plugin metadata for GitHub Copilot and Claude Code. Keep shared product identity fields aligned across the manifests when changing the plugin name, description, version, author, repository, keywords, license, skills path, or MCP wiring.

**Shared assets** used by the plugin ecosystems:
- `skills\microsoft-build\SKILL.md` — the active skill prompt
- `skills\microsoft-events\SKILL.md` — the active skill prompt
- `.mcp.json` — Microsoft Learn MCP endpoint config
- `cli\` — source for the `@microsoft/events-cli` package used by the skill

Expand All @@ -17,9 +17,9 @@ The repo publishes plugin metadata for GitHub Copilot and Claude Code. Keep shar

## Sync rules

- Event support is duplicated by design between the CLI and skill docs. When adding, removing, or renaming events, update `cli\src\config.ts`, the supported/default event guidance in `skills\microsoft-build\SKILL.md`, and affected tests/docs together.
- Treat `skills\microsoft-build\SKILL.md` as the product contract for event-session behavior. For Build, Ignite, or event-session work: default "Build" to `build-2026`, get session metadata from the live catalog through `msevents` or the endpoint, get SDK/API facts from Microsoft Learn MCP, and never invent session IDs, speakers, schedules, or links.
- Versioning gate: any meaningful `skills\microsoft-build\SKILL.md` change (agent behavior, commands/examples agents may follow, supported/default events, CLI/MCP/catalog usage, or user-facing workflow guidance) must bump both versioned plugin manifests to the same value; patch bumps are fine for guidance-only changes.
- Event support is duplicated by design between the CLI and skill docs. When adding, removing, or renaming events, update `cli\src\config.ts`, the supported/default event guidance in `skills\microsoft-events\SKILL.md`, and affected tests/docs together.
- Treat `skills\microsoft-events\SKILL.md` as the product contract for event-session behavior. For Build, Ignite, or event-session work: default "Build" to `build-2026`, get session metadata from the live catalog through `msevents` or the endpoint, get SDK/API facts from Microsoft Learn MCP, and never invent session IDs, speakers, schedules, or links.
- Versioning gate: any meaningful `skills\microsoft-events\SKILL.md` change (agent behavior, commands/examples agents may follow, supported/default events, CLI/MCP/catalog usage, or user-facing workflow guidance) must bump both versioned plugin manifests to the same value; patch bumps are fine for guidance-only changes.
- PR review gate: GitHub Copilot/code reviewers should flag meaningful `SKILL.md` changes without synced plugin version bumps, and any plugin version drift. Typo/format-only skill edits may skip the bump only when the PR explicitly says so.
- Keep README install/client guidance aligned with plugin manifest, skill, MCP, or CLI behavior changes.

Expand Down
Binary file modified Build-CLI.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 22 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Microsoft Build CLI
# Microsoft Events CLI

A [GitHub Copilot CLI](https://github.com/features/copilot/cli/) skill that connects your local project to the Microsoft Build session catalog. It reads your dependencies, finds relevant sessions, and helps you act on what you learn — all from your terminal.
A [GitHub Copilot CLI](https://github.com/features/copilot/cli/) skill that connects your local project to Microsoft event session catalogs. It reads your dependencies, finds relevant sessions, and helps you act on what you learn — all from your terminal.

![Build CLI](Build-CLI.png)
![Microsoft Events CLI](Build-CLI.png)

## Quick Start

Expand All @@ -16,10 +16,10 @@ A [GitHub Copilot CLI](https://github.com/features/copilot/cli/) skill that conn
```
3. Try:
```
What Build sessions are relevant to my project?
What Ignite 2026 sessions are relevant to my project?
```

The skill reads `package.json`, `requirements.txt`, `.csproj`, `go.mod`, and other dependency files, maps them to Microsoft products, and searches the live Build 2026 session catalog.
The skill reads `package.json`, `requirements.txt`, `.csproj`, `go.mod`, and other dependency files, maps them to Microsoft products, and searches live event catalogs (default: Ignite 2026).

## Requirements

Expand All @@ -30,49 +30,51 @@ The skill reads `package.json`, `requirements.txt`, `.csproj`, `go.mod`, and oth

📺 **[Watch the overview video](https://www.youtube.com/watch?v=gm8gKtrd3po)** to see it in action.

### Before Build — plan your schedule
### Before an event — plan your schedule

| Ask the skill to… | Example |
|------------------------------------------|-------------------------------------------------------|
| Find sessions for your project | *"What Build sessions should I attend?"* |
| See what's new for your tech stack | *"What's new at Build for Azure Cosmos DB?"* |
| Look up a session by code | *"Tell me about session BRK155"* |
| Build a personalized session path | *"Find sessions for me for an IT admin focused on Entra, Intune, and Defender."* |
| See what's new for your stack | *"What's new for me at Ignite with Node.js, TypeScript, Functions, and Cosmos DB?"* |
| Look up a specific session | *"Tell me about session BRK155."* |

### During Build — capture what matters
### During an event — capture what matters

| Ask the skill to… | Example |
|------------------------------------------|-------------------------------------------------------|
| Log notes tied to a session | *"Log a note from session BRK155: great agent demo"* |
| Get next steps after a session | *"What should I do after session BRK155?"* |
| Log notes tied to a session | *"Log a note from session BRK155: key governance steps and rollout risks."* |
| Get immediate follow-up actions | *"What should I do after session BRK155?"* |
| Build a supplemental learning path | *"Build a supplemental learning path for BRK155 and BRK223."* |

### After Build — ship what you learned
### After an event — ship what you learned

| Ask the skill to… | Example |
|------------------------------------------|-------------------------------------------------------|
| Scaffold a project from a session | *"Scaffold a project from session BRK155"* |
| See what changed for your project | *"What changed at Build for my project?"* |
| Create an operational checklist | *"Create an operational learning checklist from BRK155 for our IT admin team."* |
| Scaffold from a technical session | *"Scaffold a project from session BRK155."* |
| Ground recommendations in your context | *"Ground recommendations in my authorized context and show traceability."* |

## How It Works

The skill is a thin layer over the **live Build 2026 catalog API** — no stale data, no manual updates. For SDK docs and code samples, it falls back to the [Microsoft Learn MCP Server](https://learn.microsoft.com/training/support/mcp).
The skill is a thin layer over **live Microsoft event session catalogs** — no stale data, no manual updates. For SDK docs and code samples, it falls back to the [Microsoft Learn MCP Server](https://learn.microsoft.com/training/support/mcp).

Session results are a starting point. For broad topics, ask the agent to refine (*"show me more Foundry sessions about observability"*) or browse the full catalog at [build.microsoft.com/sessions](https://build.microsoft.com/sessions).
Session results are a starting point. For broad topics, ask the agent to refine (*"show me more Foundry sessions about observability"*) or browse full catalogs at [ignite.microsoft.com/sessions](https://ignite.microsoft.com/sessions) and [build.microsoft.com/sessions](https://build.microsoft.com/sessions).

> [!NOTE]
> Build-CLI targets **Build 2026** and also indexes past events (Build 2025, Ignite 2025). It supports any future event that follows the same catalog endpoint pattern. It is not a replacement for the event app or session browser — it's a developer-first complement to them.
> This skill defaults to **Ignite 2026** and also supports Build 2026, Ignite 2025, and Build 2025 catalogs. It is not a replacement for the event app or session browser — it's a developer and IT-pro complement to them.

## Supported Clients

| Client | Configuration |
|--------|---------------|
| GitHub Copilot CLI | `/plugin install microsoft/Build-CLI` then `/restart` |
| VS Code | Open Extensions (Ctrl+Shift+X), search `@agentPlugins microsoft-events`, and install |
| Visual Studio 2026 | Copy `skills/microsoft-build/` to a [supported skill location](https://learn.microsoft.com/visualstudio/ide/copilot-agent-skills) |
| Visual Studio 2026 | Copy `skills/microsoft-events/` to a [supported skill location](https://learn.microsoft.com/visualstudio/ide/copilot-agent-skills) |
| Claude Code | `/plugin marketplace add microsoft/Build-CLI` then `/plugin install microsoft-events@microsoft-events-marketplace` |

## Scope and Limitations

- **Event-scoped:** Targets Build 2026, with Build 2025 and Ignite 2025 also available. The architecture supports any event that uses the same catalog endpoints.
- **Event-scoped:** Defaults to Ignite 2026, with Build 2026, Ignite 2025, and Build 2025 also available. The architecture supports any event that uses the same catalog endpoints.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I noticed the Ignite 2025 and Build 2025 endpoints now return 404. Have they been retired?

- **Dependency-driven:** Recommendations are only as good as the dependency files in your project root. If your project doesn't have a manifest file, tell the skill your stack directly.
- **Not offline:** Requires network access to query the catalog and Learn MCP server.

Expand Down
Loading
Loading