Skip to content
Back to search

discovery

Microsoft Discovery community repository

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/microsoft/discovery with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/microsoft/discovery'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microsoft--discovery/badge.svg)](/listings/microsoft--discovery)

HTML

<a href="/listings/microsoft--discovery"><img src="/api/listings/microsoft--discovery/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The Microsoft Discovery app is a **self-contained desktop application** — no SDK, no cloud setup, no IT ticket. Download the latest release installer and follow the [Quickstart guide](docs/discovery-app/quickstart.md) to get started.

**Have feedback?** See [`docs/discovery-app/feedback.md`](docs/discovery-app/feedback.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 217 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # ⬇️ Download the Discovery app
  2. <table>
  3. <tr>
  4. <td align="center" width="320">
  5. <img src="includes/media/windows.svg" width="96" height="96" alt="Windows logo"><br>
  6. <a href="https://aka.ms/discovery/download/preview/x64/current"><img src="includes/media/windows-download-card.svg" width="220" height="80" alt="Download Windows 11"></a><br>
  7. <strong>User Installer</strong>
  8. <a href="https://aka.ms/discovery/download/preview/x64/current"><strong>x64</strong></a>
  9. <a href="https://aka.ms/discovery/download/preview/arm64/current"><strong>Arm64</strong></a>
  10. <a href="https://aka.ms/discovery/download/preview/osx/current"><strong>macOS</strong></a>
  11. <a href="https://aka.ms/discovery/download/preview/rhel/current"><strong>RHEL</strong></a>
  12. </td>
  13. <td valign="middle">
  14. A self-contained desktop app - no SDK, no cloud setup. Current release: <strong>v0.15.21</strong>.<br>
  15. <sub>Windows x64, Windows ARM64, macOS, and RHEL x64 (RPM) installers are available today.</sub><br><br>
  16. 🛠️ <a href="docs/discovery-app/install.md">Install guide</a> - setup, verification, and upgrade steps.
  17. </td>
  18. </tr>
  19. </table>
  20. **Previous release** — this repo keeps only the current and the immediately preceding version available for download.
  21. | Version | Date | Platform | Installer |
  22. | --- | --- | --- | --- |
  23. | v0.15.20 _(previous)_ | 2026-10-20 | Windows x64 | [`Discovery-app-0.15.20-preview-win-x64.exe`](https://aka.ms/discovery/download/preview/x64/previous) |
  24. | v0.15.20 _(previous)_ | 2026-10-20 | Windows Arm64 | [`Discovery-app-0.15.20-preview-win-arm64.exe`](https://aka.ms/discovery/download/preview/arm64/previous) |
  25. | v0.15.20 _(previous)_ | 2026-10-20 | macOS | [`Discovery-app-0.15.20-preview-osx-arm64.dmg`](https://aka.ms/discovery/download/preview/osx/previous) |
  26. | v0.15.20 _(previous)_ | 2026-10-20 | RHEL x64 | [`discovery-app-preview-0.15.20-1.el9.x86_64.rpm`](https://aka.ms/discovery/download/preview/rhel/previous) |
  27. ---
  28. # Microsoft Discovery community
  29. Welcome to the **Microsoft Discovery community** — the public home for the Discovery platform, where users, partners, and the product team build together. We're proud to announce that the [Microsoft Discovery Discussions forum](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions) is now open on the Microsoft Community Hub! Share what you've built, ask questions, file bugs, suggest ideas, and see what other Discovery users are doing across disciplines.
  30. > **Microsoft Discovery is an extensible platform that brings together agentic orchestration, advanced reasoning, a graph-based knowledge foundation, and high-performance computing for accelerating scientific research and R&D workflows.**
  31. Microsoft Discovery is offered in two complementary experiences: an enterprise-grade platform powered by Azure, and a local app with select features and capabilities. The two share the same core concepts and features.
  32. | Experience | What it is | Where to start |
  33. | --- | --- | --- |
  34. | 🖥️ **Microsoft Discovery app** | A local, desktop client for individual evaluation. **Distributed from this repository.** | [`docs/discovery-app/`](docs/discovery-app/) — install, quickstart, feedback |
  35. | ☁️ **Microsoft Discovery** | The cloud-hosted, team-scale experience on Azure. | [Microsoft Learn](https://learn.microsoft.com/en-us/azure/microsoft-discovery/) — full reference |
  36. In addition, this repository hosts the **public Discovery Catalog** — the canonical metadata catalog of AI research **agents** and **starter kits** contributed by Microsoft and ecosystem partners. Agent code, container images, and model weights live in each contributor's own infrastructure; the metadata and documentation that describe them live here, where they are PR-reviewed, schema-validated, and surfaced to every Discovery user.
  37. ---
  38. ## 🧭 Core concepts
  39. The canonical conceptual reference for both the app and the services is [Microsoft Discovery on Microsoft Learn](https://learn.microsoft.com/en-us/azure/microsoft-discovery/). The starting points most users want:
  40. - [Microsoft Discovery & the Microsoft Discovery app](https://learn.microsoft.com/azure/microsoft-discovery/concept-discovery-and-discovery-app) - detailed comparison of Discovery experiences
  41. - [Discovery Agent concepts](https://learn.microsoft.com/azure/microsoft-discovery/concept-discovery-agent) — what an agent is and how it's invoked
  42. - [Discovery Engine overview](https://learn.microsoft.com/azure/microsoft-discovery/concept-discovery-engine) — the cognition layer
  43. - [Bookshelf and Knowledge Bases](https://learn.microsoft.com/azure/microsoft-discovery/concept-bookshelf-knowledge-bases) — how indexing and retrieval work
  44. - [Tasks and investigations](https://learn.microsoft.com/azure/microsoft-discovery/concept-tasks-investigations) — the task-graph model
  45. For an app-specific 15-minute hands-on tour, see [`docs/discovery-app/quickstart.md`](docs/discovery-app/quickstart.md).
  46. ---
  47. ## 📦 What's in this repository
  48. | Surface | What it is | Best for |
  49. | --- | --- | --- |
  50. | 🤖 **[`agents/`](/agents/)** | Catalog of AI research agents (1P and 3P) surfaced in Discovery. Each entry contains a `metadata.yaml`, `agent.yaml`, `README.md`, and optional `tools/`. | Browsing what's available, or contributing a new agent. |
  51. | 📑 **[`docs/`](/docs/)** | Documentation and pointers for both Microsoft Discovery and the Discovery app, including documentation for authoring guides and schemas. | Learning more about Discovery experiences and best practices. |
  52. | 🎥 **[How to videos](/docs/how-to-videos/README.md)** | Curated how-to video content for Discovery workflows and onboarding. | Watching guided walkthroughs and quick task demos. |
  53. | 🧰 **[`starter-kits/`](/starter-kits/)** | Catalog of starter kits — `kit.json` manifests that bundle one or more catalog agents into a launchable scenario. | Browsing pre-built workflows, or publishing a new kit. |
  54. | 🧩 **[`skills/`](/skills/)** | Catalog of [Agent Skills](https://agentskills.io) — `SKILL.md` folders that package a reusable workflow any agent can load on demand. | Reusing proven research workflows, or publishing one of your own. |
  55. | 🧭 **[QuickStart Scenarios](quickstarts/README.md)** | Guides and supporting files for BioPharma, Silicon and Physics, Chemistry and Materials Science, and Bookshelf workflows. | Choose a scenario, check its availability and requirements, and start in a fresh project. |
  56. | 💬 **[Discussions](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions)** | Q&A, Ideas, Bugs, and Show-and-tell — the single place for everything from "how do I…?" to bug reports, ideas, and sharing what you've built. | Asking questions, suggesting ideas, sharing what you've built, and reporting bugs. |
  57. | 🧪 **[`.github/skills/`](.github/skills/)** | Three Copilot skills auto-discovered by Copilot CLI and VS Code Copilot Chat — for browsing the catalog and deploying agents / starter kits to **Microsoft Discovery services** (cloud, via Microsoft Foundry). Not used by the local Discovery app today. | Researchers and developers integrating the catalog into a Microsoft Foundry workflow. |
  58. ---
  59. ## 🚀 Get started
  60. ### Install and use the Discovery app
  61. The Microsoft Discovery app is a **self-contained desktop application** — no SDK, no cloud setup, no IT ticket. Download the latest release installer and follow the [Quickstart guide](docs/discovery-app/quickstart.md) to get started.
  62. **Have feedback?** See [`docs/discovery-app/feedback.md`](docs/discovery-app/feedback.md).
  63. ### Browse the catalog
  64. - **Agents:** open the `agents/` directory — each folder is one agent with its own `README.md`.
  65. - **Starter kits:** open the `starter-kits/` directory — each folder contains a single `kit.json` describing the bundled agents, sample prompts, and risk profile.
  66. - **Programmatic access:** the same content is exposed in [`.auto-registry/agent-registry.json`](.auto-registry/agent-registry.json) and [`.auto-registry/starter-kit-registry.json`](.auto-registry/starter-kit-registry.json). Catalog changes trigger registry generation; updates are proposed in a separate PR and reach `main` after human review and maintainer-controlled merging.
  67. ---
  68. ## 🤝 Contributing
  69. All contributions — from Microsoft engineers and external partners — arrive via **pull request from a fork**. Direct pushes to `main` are not permitted.
  70. Public contributors may submit catalog content and documentation directly by
  71. pull request. Changes to trusted automation, repository configuration, schemas,
  72. generated output, and executable utilities are security-sensitive and require
  73. maintainer/CODEOWNER review; discuss substantial proposals through the matching
  74. Discussions category before opening a pull request.
  75. | Type | Goes to | First read |
  76. | --- | --- | --- |
  77. | **New agent** | `agents/<agent-name>/` | [Agent authoring guide](docs/authoring-guides/agent-authoring-guide.md) |
  78. | **New starter kit** | `starter-kits/<kit-name>/` | [Starter-kit authoring guide](docs/authoring-guides/starter-kit-authoring-guide.md) |
  79. | **New skill** | `skills/<skill-name>/` | [Skill authoring guide](docs/authoring-guides/skill-authoring-guide.md) |
  80. | **Documentation fix** | `docs/`, `README.md`, etc. | [`CONTRIBUTING.md`](CONTRIBUTING.md) |
  81. | **Idea / feature request** | [Discussions → Ideas](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions) | — |
  82. | **Bug** | [Discussions → Bugs](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions) | — |
  83. | **Question** | [Discussions → Q&A](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions) | — |
  84. | **Something you built** | [Discussions → Show and tell](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions) | — |
  85. | **Schema / workflow change** | PR against `docs/schemas/` or `.github/workflows/` — **Microsoft maintainers only**; open an Idea first. | [`CONTRIBUTING.md`](CONTRIBUTING.md) |
  86. Start with the quick contribution guide in [`CONTRIBUTING.md`](CONTRIBUTING.md).
  87. Read-only PR checks validate structure, schemas, policy, documentation, and
  88. secrets. A separate reporter publishes diagnostic labels and comments
  89. asynchronously; available rule feedback includes IDs and remediation hints.
  90. Required checks and source run logs remain authoritative if feedback is missing.
  91. See the [workflow overview](.github/workflows/README.md#pull-request-validation-and-feedback)
  92. for check names, reporting boundaries, and the manual review/merge process.
  93. ### Quick start for catalog contributors
  94. ```bash
  95. # Fork microsoft/discovery on GitHub, then:
  96. git clone https://github.com/<your-alias>/discovery.git
  97. cd discovery
  98. git remote add upstream https://github.com/microsoft/discovery.git
  99. # Create a branch and add your agent (or starter-kit) folder
  100. git checkout -b add-my-agent
  101. mkdir agents/my-agent
  102. # … author metadata.yaml, agent.yaml, README.md (see authoring guide)
  103. # Push and open a PR targeting upstream/main
  104. git push origin add-my-agent
  105. ```
  106. ---
  107. ## 🆘 Getting help
  108. Everything community-facing goes to the **[Microsoft Discovery Discussions forum](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions)**, posted in the matching category:
  109. - **Questions / how-to** → [Q&A](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions)
  110. - **Bugs** → [Bugs](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions)
  111. - **Ideas** → [Ideas](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions)
  112. - **Show what you've built** → [Show and tell](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions)
  113. For security-sensitive reports, follow [`SECURITY.md`](SECURITY.md) — **do not** open a public Discussion or issue for vulnerabilities.
  114. ---
  115. ## 🗂️ Repository layout
  116. ```text
  117. discovery/
  118. ├── agents/
  119. │ └── <agent-name>/ ← flat catalog: one folder per agent
  120. │ ├── metadata.yaml ← Discovery catalog contract (required)
  121. │ ├── agent.yaml ← Prompt-agent definition (required)
  122. │ ├── README.md ← Agent documentation (required)
  123. │ └── tools/<tool-name>/ ← Discovery-managed tools (optional)
  124. │ ├── tool.yaml
  125. │ └── Dockerfile
  126. ├── starter-kits/
  127. │ └── <kit-name>/ ← flat catalog: one folder per kit
  128. │ └── kit.json ← Starter-kit manifest (required)
  129. │ └── README.md ← Optional, but recommended
  130. │ └── media/ ← Required only if images are used in Markdown files
  131. ├── skills/
  132. │ └── <skill-name>/ ← flat catalog: one folder per skill (Agent Skills standard)
  133. │ ├── SKILL.md ← Skill instructions + frontmatter (required)
  134. │ └── scripts/ references/ assets/ ← Optional bundled resources
  135. ├── .auto-registry/ ← Auto-generated catalog registries; do not edit by hand
  136. │ ├── agent-registry.json ← Aggregated agent metadata from agents/*/
  137. │ └── starter-kit-registry.json ← Aggregated starter-kit metadata from starter-kits/*/
  138. ├── docs/
  139. │ ├── discovery-app/ ← End-user docs for the Discovery app
  140. │ │ ├── install.md
  141. │ │ ├── quickstart.md
  142. │ │ └── feedback.md
  143. │ ├── discovery-services/ ← Pointer to Microsoft Learn (services live there)
  144. │ ├── authoring-guides/ ← How to author and submit catalog content
  145. │ │ ├── agent-authoring-guide.md
  146. │ │ ├── starter-kit-authoring-guide.md
  147. │ │ └── skill-authoring-guide.md
  148. │ └── schemas/ ← Canonical JSON schemas (*-schema.json)
  149. ├── utilities/ ← Operator PowerShell scripts for Discovery services (resource-provider registration, RBAC, data-asset migration)
  150. ├── .github/
  151. │ ├── skills/ ← Copilot skills (auto-discovered)
  152. │ │ ├── discovery-catalog/ ← Read-only catalog inventory
  153. │ │ ├── discovery-services-agent-deployer/ ← Agent deployment to Microsoft Foundry
  154. │ │ ├── discovery-services-starter-kit-deployer/ ← Starter-kit deployment to Microsoft Foundry
  155. │ │ └── README.md ← Skill documentation
  156. │ ├── DISCUSSION_TEMPLATE/ ← Templates for Bugs / Ideas / Q&A / Show-and-tell
  157. │ ├── workflows/ ← Automated PR validation and registry pipelines
  158. │ ├── scripts/ ← Python validation and registry-builder scripts
  159. │ ├── CODEOWNERS ← Maintainer assignments
  160. │ └── pull_request_template.md
  161. └── .vscode/ ← Editor settings: wires JSON Schemas to YAML/JSON files; recommends Copilot, PowerShell, Python, YAML, and markdownlint extensions
  162. ```
  163. > The catalog uses a **flat layout** — there is no Microsoft-versus-partner folder split. The optional `party` field inside `metadata.yaml` and `kit.json` (`1p` for Microsoft-authored, `3p` for partner-contributed) drives PR labels and surfacing; it is not encoded in the folder path.
  164. ---
  165. ## ⚖️ Terms
  166. This project follows the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). To report a security vulnerability, see [`SECURITY.md`](SECURITY.md).
  167. **Trademarks** — this project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third parties' policies.
  168. Third-party agent entries in the catalog are governed solely by each partner's own terms — see the individual agent `README.md` for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.