dotnet-skills
Installable .NET skill catalog and CLI for Codex, Claude Code, GitHub Copilot, and Gemini.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
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/managedcode/dotnet-skills 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/managedcode/dotnet-skills'
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
Markdown
[](/listings/managedcode--dotnet-skills)HTML
<a href="/listings/managedcode--dotnet-skills"><img src="/api/listings/managedcode--dotnet-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
dotnet tool install --global dotnet-skills # choose one dedicated agent launcher dotnet tool install --global dotnet-agents dotnet tool install --global agents dotnet skills # open the interactive control center dotnet skills version # show current tool version and latest NuGet version dotnet skills --version # alias for the same version view dotnet skills list # show installed and available skills dotnet skills bundle list # show focused bundles by collection and workflow dotnet skills list --local # only installed skills in the current target dotnet skills recommend # suggest skills from local .NET and browser UI signals dotnet skills install --auto # install skills from local .NET and browser UI project signals dotnet skills install --auto --prune # remove stale auto-managed skills that no longer match the project dotnet skills install bundle quality # install a focused .NET quality bundle dotnet skills install mcaf # install the opt-in MCAF governance skill dotnet skills install bundle orleans # install the Orleans workflow bundle dotnet skills install aspire orleans # install skills dotnet skills catalog tokens --catalog-root . # export per-skill token counts as JSON dotnet skills remove aspire # remove one installed skill dotnet skills remove bundle quality # remove every skill from a focused bundle dotnet skills remove collection distributed # remove every skill from a collection dotnet skills remove --all # remove installed catalog skills from the target dotnet skills update # refresh installed catalog skills dotnet skills install blazor --agent claude # install for a specific agent dotnet agents list # show bundled orchestration agents dotnet agents install router --auto # install agents to shared or detected agent folders agents list # same agent-only catalog via the plain standalone command agents install router --auto # same agent install flow without the dotnet-prefixed launcher
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 · 475 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.
- # dotnet-skills
- [](https://www.nuget.org/packages/dotnet-skills)
- [](LICENSE)
- [](https://skills.managed-code.com/skills/)
- [](https://dotnet.microsoft.com/)
- **Stop explaining .NET to your AI. Start building.**
- We've all been there: asking Claude to use Entity Framework, only to get EF6 patterns in a .NET 8 project. Explaining to Copilot that Blazor Server and Blazor WebAssembly aren't the same thing. Watching Codex generate `Startup.cs` for a Minimal API project.
- <!-- BEGIN CATALOG SUMMARY -->
- This catalog fixes that. **203 skills make dotnet-skills one of the largest .NET-focused skill collections for AI coding assistants**, with explicit mappings for **54 NuGet packages**. It covers the ecosystem—from ASP.NET Core to Orleans, from MAUI to Semantic Kernel. Install them once, and your AI agent actually knows modern .NET.
- <!-- END CATALOG SUMMARY -->
- **[Browse the complete catalog on skills.managed-code.com →](https://skills.managed-code.com/skills/)**
- ## Interactive Control Center
- Run `dotnet skills` to open the full-screen control center for catalog browsing, project-aware recommendations, installation, updates, and agent management.
- 
- Explore the catalog as `Collection -> Lane -> Skill`, with installed coverage, token weight, and an install action kept visible while you browse.
- 
- Use the analysis surface to compare the heaviest skills, collection sizes, package signals, and the catalog's token distribution before installing.
- 
- ## Why This Matters
- - **No more outdated patterns.** Skills are maintained by the community and track official Microsoft documentation.
- - **Works everywhere.** Same skills for Claude, Copilot, Gemini, Codex, and Junie.
- - **Community-driven.** Missing a skill for your favorite library? Add it and help everyone.
- **Your favorite .NET library deserves a skill.** If you maintain an open-source project or just love a framework that's missing, [contribute it](CONTRIBUTING.md). Let's make AI agents actually useful for .NET developers.
- ## Quick Start
- ```bash
- dotnet tool install --global dotnet-skills
- # choose one dedicated agent launcher
- dotnet tool install --global dotnet-agents
- dotnet tool install --global agents
- dotnet skills # open the interactive control center
- dotnet skills version # show current tool version and latest NuGet version
- dotnet skills --version # alias for the same version view
- dotnet skills list # show installed and available skills
- dotnet skills bundle list # show focused bundles by collection and workflow
- dotnet skills list --local # only installed skills in the current target
- dotnet skills recommend # suggest skills from local .NET and browser UI signals
- dotnet skills install --auto # install skills from local .NET and browser UI project signals
- dotnet skills install --auto --prune # remove stale auto-managed skills that no longer match the project
- dotnet skills install bundle quality # install a focused .NET quality bundle
- dotnet skills install mcaf # install the opt-in MCAF governance skill
- dotnet skills install bundle orleans # install the Orleans workflow bundle
- dotnet skills install aspire orleans # install skills
- dotnet skills catalog tokens --catalog-root . # export per-skill token counts as JSON
- dotnet skills remove aspire # remove one installed skill
- dotnet skills remove bundle quality # remove every skill from a focused bundle
- dotnet skills remove collection distributed # remove every skill from a collection
- dotnet skills remove --all # remove installed catalog skills from the target
- dotnet skills update # refresh installed catalog skills
- dotnet skills install blazor --agent claude # install for a specific agent
- dotnet agents list # show bundled orchestration agents
- dotnet agents install router --auto # install agents to shared or detected agent folders
- agents list # same agent-only catalog via the plain standalone command
- agents install router --auto # same agent install flow without the dotnet-prefixed launcher
- ```
- ## Commands
- | Command | Description |
- |---------|-------------|
- | `dotnet skills` | Open the interactive control center with direct skill browsing, collections, analysis, bundles, and install preview |
- | `dotnet skills version` | Show the current installed tool version and check whether NuGet has a newer release |
- | `dotnet skills list` | Show the current inventory, compare project/global scope when relevant, and keep the remaining catalog as a compact collection summary |
- | `dotnet skills bundle list` | Show the focused bundles that expand into related skills by collection or workflow |
- | `dotnet skills recommend` | Scan local `*.csproj`, `package.json`, and browser UI files, propose relevant skills, and let you decide what to install |
- | `dotnet skills install --auto` | Inspect local `*.csproj`, `package.json`, and browser UI files, detect strong project signals, and install matching skills automatically |
- | `dotnet skills install --auto --prune` | Remove stale auto-managed skills that no longer match the current project's NuGet packages or app-model signals |
- | `dotnet skills install <skill...>` | Install one or more skills |
- | `dotnet skills install bundle <bundle...>` | Install one or more focused bundles such as `quality`, `frontend-quality`, or `orleans` |
- | `dotnet skills catalog tokens --catalog-root .` | Export the tokenizer model name plus per-skill token counts as JSON |
- | `dotnet skills remove <skill...>` | Remove one or more installed catalog skills by skill id or alias |
- | `dotnet skills remove bundle <bundle...>` | Remove every installed skill mapped to one or more focused bundles |
- | `dotnet skills remove collection <collection...>` | Remove every installed skill in one or more collections |
- | `dotnet skills remove --all` | Remove every installed catalog skill from the selected target |
- | `dotnet skills update [skill...]` | Update installed catalog skills to the selected catalog version |
- | `dotnet skills sync` | Download latest catalog |
- | `dotnet skills where` | Show install paths |
- | `dotnet agents list` | List available orchestration agents |
- | `dotnet agents install <agent...>` | Install orchestration agents |
- | `dotnet agents install router --auto` | Install agents to all detected platforms |
- | `dotnet agents remove <agent...>` | Remove installed agents |
- | `dotnet agents where` | Show resolved shared or platform agent install paths |
- | `agents list` | List available orchestration agents through the standalone `agents` tool |
- | `agents install <agent...>` | Install orchestration agents through the standalone `agents` tool |
- | `agents where` | Show resolved agent install paths through the standalone `agents` tool |
- Use `--agent` to target a specific agent platform, `--scope` to choose global or project install. Use `dotnet skills list --installed-only` or the shorter `dotnet skills list --local` when you only want the installed inventory, or `--available-only` when you want the detailed collection-by-collection breakdown of the remaining catalog. The default `list` view stays compact: it shows the current target inventory, compares project/global scope when that comparison is meaningful, and keeps the remaining catalog as a short collection summary instead of dumping one giant description table. The CLI renders rich terminal tables by default so you can quickly see installed versions, update candidates, install commands, and when a newer `dotnet-skills`, `dotnet-agents`, or `agents` package is available on NuGet. `dotnet skills --version`, `dotnet agents --version`, and `agents --version` are shortcuts for the version view.
- `dotnet-skills` remains the skill-first CLI and still supports `dotnet skills agent ...` for compatibility. The dedicated agent-only surface is published in both forms: `dotnet-agents` for `dotnet agents ...` and `agents` for `agents ...`. Both top-level `list`, `install`, `remove`, and `where` commands target orchestration agents directly.
- The interactive shell behind bare `dotnet skills` is the main control center: its primary catalog row now mirrors the public site with `Packages`, `Bundles`, `Collections`, `Skills`, `Agents`, and `About`, then layers CLI-only lifecycle surfaces such as `Project`, `Installed`, `Analysis`, and `Workspace` underneath. Inside that control center you still get direct individual-skill picking, `Collection -> Lane -> Skill` browsing, package-entry analysis, token hotspots, a full tree view, and install preview before files are written.
- The [public catalog](https://skills.managed-code.com/) is the canonical browse surface for `Packages`, `Bundles`, `Collections`, `Skills`, `Agents`, and `About`. It uses the same shared navigation manifest and collection taxonomy as the CLI.
- `dotnet skills bundle list` shows the ready-made focused bundles. Bundle installs are bulk shortcuts for related skill sets, so `dotnet skills install bundle quality`, `dotnet skills install bundle frontend-quality`, or `dotnet skills install bundle orleans` install every skill mapped to that focused bundle in one pass. MCAF is one opt-in governance skill and installs directly with `dotnet skills install mcaf`.
- `dotnet skills install --auto` inspects local `*.csproj`, `package.json`, and browser UI files, detects NuGet packages plus strong .NET and frontend framework signals, and installs the matching skills for that project automatically. Add `dotnet skills install --auto --prune` when you also want to remove stale auto-managed skills that no longer match the current project. Protected diagnostic skills and `graphify-dotnet` are not pruned.
- `dotnet skills recommend` is a scan-only command: it inspects local .NET projects plus Astro, React, Blazor, and other browser UI signals, proposes a skill list, and prints the install command you can run if you agree with the recommendations. It does not install anything automatically.
- The bare `dotnet skills` usage view and `help` path also perform the automatic self-update check, so an outdated tool still tells you to upgrade before it renders the command table.
- Use `dotnet skills version --no-check`, `dotnet agents version --no-check`, or `agents version --no-check` when you only want the local installed tool version without calling NuGet. Set `DOTNET_SKILLS_SKIP_UPDATE_CHECK=1`, `DOTNET_AGENTS_SKIP_UPDATE_CHECK=1`, or `AGENTS_SKIP_UPDATE_CHECK=1` if you want to suppress automatic update notices during normal command startup.
- ## Local Preview
- When you want to preview the generated docs and public site locally:
- ```bash
- python3 scripts/generate_catalog.py --validate-only
- python3 scripts/generate_pages.py
- ```
- The README stays intentionally compact. The generated catalog site is written to `artifacts/github-pages/` with the same shared `Packages / Bundles / Collections / Skills / Agents / About` navigation that the public site and CLI home surface use.
- ## Install Surface
- Public bundle installs use `bundle`, not `package`. The focused bundle surface is intentionally small:
- - `foundations`
- - `quality`
- - `frontend-quality`
- - `architecture-core`
- - `testing-base`
- - `testing-xunit`
- - `testing-nunit`
- - `testing-mstest`
- - `testing-tunit`
- - `testing-migrations`
- - `runtime-upgrades`
- - `orleans`
- Collections are intentionally split so installs stay explicit instead of collapsing into one overloaded `.NET` bucket:
- - `.NET Foundations`
- - `.NET Quality`
- - `MSBuild`
- - `NuGet & Publishing`
- - `Templates & Scaffolding`
- - `Diagnostics & Metrics`
- - `Web`
- - `Aspire`
- - `Azure Functions`
- - `Background Workers`
- - `Mobile & Device`
- - `XR & Spatial`
- - `Desktop & UI`
- - `Frontend Quality`
- - `Testing`
- - `Testing Research`
- - `Architecture`
- - `Governance & Delivery`
- - `Data`
- - `AI & Agents`
- - `Distributed`
- - `Legacy`
- - `Upgrades & Migration`
- For MCP-driven runtime profiling, install [`diagnostics-mcp`](catalog/Tools/DotNet-Diagnostics-MCP/skills/diagnostics-mcp/) with `dotnet skills install diagnostics-mcp`. It covers `dotnet-diagnostics-mcp` setup, CPU/allocation/GC capture, and the prompt: "Profile all unit tests and identify bottlenecks in the code tested." It belongs to `Diagnostics & Metrics`, with test-host discovery and explicit profiling-coverage reporting.
- Catalog releases are published automatically in `.github/workflows/publish-catalog.yml` at `04:00` UTC and include the `catalog-v*` release, GitHub Pages deployment, and NuGet publish for `dotnet-skills`, `dotnet-agents`, and `agents` in the same run. Automatic catalog versions use a numeric calendar-plus-daily-index format such as `2026.3.15.0`, where the first UTC-day release is `.0`, the second is `.1`, and so on. `dotnet-skills` reads the newest non-draft `catalog-v*` release by default, and `--catalog-version` is only for intentional pinning.
- Install whichever dedicated agent package you prefer:
- - `dotnet tool install --global dotnet-agents` gives you the `dotnet agents ...` command shape.
- - `dotnet tool install --global agents` gives you the `agents ...` command shape.
- ## Agent Support
- ### Skills Installation Paths
- | Agent | Global | Project |
- |-------|--------|---------|
- | Claude | `~/.claude/skills/` | `.claude/skills/` |
- | Copilot | `~/.copilot/skills/` | `.github/skills/` |
- | Gemini | `~/.gemini/skills/` | `.gemini/skills/` |
- | Codex | `$CODEX_HOME/skills/` (default: `~/.codex/skills/`) | `.codex/skills/` |
- | Junie | `~/.junie/skills/` | `.junie/skills/` |
- | Grok Build | `~/.grok/skills/` | `.grok/skills/` |
- | Shared Agent Skills | `~/.agents/skills/` | `.agents/skills/` |
- ### Orchestration Agents Installation Paths
- | Agent | Global | Project |
- |-------|--------|---------|
- | Claude | `~/.claude/agents/` | `.claude/agents/` |
- | Copilot | `~/.copilot/agents/` | `.github/agents/` |
- | Gemini | `~/.gemini/agents/` | `.gemini/agents/` |
- | Codex | `$CODEX_HOME/agents/` (default: `~/.codex/agents/`) | `.codex/agents/` |
- | Junie | `~/.junie/agents/` | `.junie/agents/` |
- | Grok Build | `~/.grok/agents/` | `.grok/agents/` |
- | Shared agents | `~/.agents/agents/` | `.agents/agents/` |
- If `.agents/` exists, automatic installs use its shared `skills/` or `agents/` directory. Otherwise the tool detects `.codex/`, `.claude/`, `.github/`, `.gemini/`, `.junie/`, and `.grok/`, installs into every existing native target, and falls back to `.agents/` when none exists. Use `--agent agents` for the shared target or `--agent grok` for Grok Build explicitly.
- An explicit `--target <path>` always wins. Agent commands use the portable Markdown format when `--agent` is omitted; pass a platform when you need its adapter format.
- Set `DOTNET_SKILLS_DEFAULT_TARGET` or `DOTNET_AGENTS_DEFAULT_TARGET` to keep a default destination for `dotnet skills` and `dotnet agents`. The standalone `agents` tool uses `AGENTS_DEFAULT_TARGET`. Relative values resolve below the project root for project scope and below the user home for global scope.
- ## Orchestration Agents
- This repository now tracks a parallel agent layer above the skill catalog.
- - reusable repo-authored skills, vendir-imported upstream skills, and repo-owned agents all live under package folders in `catalog/<type>/<package>/`.
- - `catalog/<type>/<package>/skills/<skill>/SKILL.md` holds the detailed implementation guidance for one skill.
- - `catalog/<type>/<package>/agents/<agent>/AGENT.md` holds routing behavior for one repo-owned orchestration agent.
- - package `manifest.json` files hold the package-level metadata that both the installer and the public site scan.
- - every skill and agent still gets its own folder so it can carry references, assets, scripts, and future installer metadata.
- - an agent can therefore represent either a grouped pack of related skills or a narrow companion to one specific skill.
- - the current `dotnet-skills` CLI remains skill-first; repo-owned agents can evolve and ship on their own track.
- - runtime-specific `.agent.md` or native Claude files should be treated as install adapters, not as the canonical repo source format.
- ```mermaid
- flowchart LR
- A["User or coding platform request"] --> B{"Broad cross-domain task?"}
- B -->|Yes| C["catalog/<type>/<package>/agents/<agent>/AGENT.md"]
- B -->|No, package-specific| D["catalog/<type>/<package>/agents/<agent>/AGENT.md"]
- C --> E["Route into catalog/<type>/<package>/skills/*"]
- D --> E
- E --> F["Apply narrow implementation guidance from SKILL.md"]
- ```
- ### Starter Agents
- | Agent | Scope | Primary routing |
- |-------|-------|-----------------|
- | [`dotnet-router`](catalog/Platform/DotNet/agents/dotnet-router/) | package-scoped | classify web, data, AI, build, UI, testing, and modernization work |
- | [`dotnet-build`](catalog/Platform/DotNet/agents/dotnet-build/) | package-scoped | restore, build, pack, CI, diagnostics |
- | [`dotnet-data`](catalog/Frameworks/Entity-Framework-Core/agents/dotnet-data/) | package-scoped | EF Core, EF6, migrations, query issues |
- | [`dotnet-frontend`](catalog/Tools/Biome/agents/dotnet-frontend/) | package-scoped | Blazor, frontend asset quality, browser-facing audits, and file-structure linting inside `.NET` repos |
- | [`dotnet-ai`](catalog/Frameworks/Semantic-Kernel/agents/dotnet-ai/) | package-scoped | Semantic Kernel, Microsoft Agent Framework, Microsoft.Extensions.AI, MCP, ML.NET |
- | [`dotnet-modernization`](catalog/Platform/Legacy-ASP.NET/agents/dotnet-modernization/) | package-scoped | upgrade, migration, and legacy modernization |
- | [`dotnet-review`](catalog/Platform/Code-Review/agents/dotnet-review/) | package-scoped | code review, analyzers, testing, architecture |
- ### Package-Scoped Specialists
- | Agent | Scope | Primary routing |
- |-------|-------|-----------------|
- | [`dotnet-orleans-specialist`](catalog/Frameworks/Orleans/agents/dotnet-orleans-specialist/) | package-scoped | Orleans grain boundaries, persistence, streams, reminders, placement, Aspire wiring, and cluster validation |
- | [`dotnet-aspire-orchestrator`](catalog/Frameworks/Aspire/agents/dotnet-aspire-orchestrator/) | package-scoped | AppHost, CLI, first-party versus CommunityToolkit/Aspire integration choice, testing, and deployment routing inside the Aspire surface |
- | [`agent-framework-router`](catalog/Frameworks/Microsoft-Agent-Framework/agents/agent-framework-router/) | package-scoped | Agent Framework agent-vs-workflow choice, `AgentThread`, tools, workflows, hosting, MCP/A2A/AG-UI, durable agents, and migration |
- ## Repository Layout
- ```text
- catalog/
- └── <Type>/
- └── <Package>/
- ├── manifest.json
- ├── icon.svg # optional
- ├── skills/
- │ └── <skill-name>/
- │ ├── SKILL.md
- │ ├── manifest.json
- │ ├── scripts/ # optional
- │ ├── references/ # optional
- │ └── assets/ # optional
- └── agents/
- └── <agent-name>/
- ├── AGENT.md
- ├── manifest.json # optional
- ├── scripts/ # optional
- ├── references/ # optional
- └── assets/ # optional
- ```
- The package-level `manifest.json` is the package control plane. It carries package title/description/icon and upstream links such as `links.repository`, `links.docs`, and `links.nuget`. Skill- or agent-specific metadata belongs in the nearest sibling `skills/<skill>/manifest.json` or `agents/<agent>/manifest.json`.
- `SKILL.md` should stay focused on routing, workflow, deliverables, and validation. Do not put `version`, `category`, `packages`, or `package_prefix` in `SKILL.md` frontmatter.
- ## External Upstream Sources
- External upstream repositories live in the dedicated [`external-sources/`](external-sources/) area.
- - `external-sources/vendir.yml` and `external-sources/vendir.lock.yml` handle fetch-and-pin only.
- - `external-sources/upstreams/` holds the checked-in vendored snapshots.
- - `external-sources/imports/*.json` is overrides-only local policy for type, category, package naming, compatibility, and skill-level package trigger metadata.
- - `scripts/import_external_catalog_sources.py` auto-discovers upstream plugins from vendored `plugin.json` and `.claude-plugin/plugin.json` files plus canonical `.agents/skills/*/SKILL.md` and `.github/skills/*/SKILL.md` trees alongside those plugins, or root `skills/*/SKILL.md` trees and a repository-root `SKILL.md` in standalone repositories, applies the local overrides, and normalizes the result into `catalog/<type>/<package>/`.
- - Imported upstream `SKILL.md`, `AGENT.md`, and supporting skill content is copied verbatim; local-only metadata stays in sibling `manifest.json` files instead of being injected into upstream markdown.
- Official imports may keep their upstream skill ids instead of being renamed to match local repo-authored conventions.
- Roslynk is imported verbatim from its [official skill tree](https://github.com/mrpmorris/Roslynk/tree/master/skills/roslynk), including its references and MIT license, and refreshed nightly. Watches track the skill's `SKILL.md`, upstream branch commits, and releases. Install it with `dotnet skills install roslynk`. Avalonia 11/12 guidance lives in `Desktop & UI`; `dotnet skills recommend` and `dotnet skills install --auto` detect Avalonia package signals. Install it directly with `dotnet skills install avalonia`. Both surfaces have upstream watches; the catalog, NuGet tools, and site are delivered together by the release workflow.
- Blazing Fast .NET is imported verbatim from [EgorBo/BlazingFastDotnet](https://github.com/EgorBo/BlazingFastDotnet), pinned through vendir and refreshed nightly. Install its performance-tuning guidance with `dotnet skills install blazing-fast-dotnet`; browse it under `Diagnostics & Metrics -> Performance`. Its upstream notes target measured tuning experiments for .NET 10 and 11.
- The official `dotnet/skills` source includes every plugin skill, including Blazor and Windows Forms, plus its repository-maintenance skills. New plugins and skills are discovered during the nightly sync without a manual allowlist. Blazor belongs to `Web`, Windows Forms to `Desktop & UI`, mobile crash analysis to `Mobile & Device`, and testing migrations to `Upgrades & Migration`. Repository-maintenance skills carry their upstream checkout and tooling requirements in sibling manifests; evaluation fixtures are outside the import surface.
- ```mermaid
- flowchart LR
- A["external-sources/vendir.yml"] --> B["external-sources/upstreams/<repo>/"]
- B --> C["plugin and canonical skill auto-discovery"]
- D["external-sources/imports/*.json (overrides only)"] --> C
- C --> E["scripts/import_external_catalog_sources.py"]
- E --> F["catalog/<type>/<package>/"]
- ```
- When you refresh vendored upstream content locally, use `bash scripts/sync_external_catalog_sources.sh`.
- ## How Updates Are Tracked
- The nightly refresh starts at `00:17 UTC` in [upstream-watch.yml](.github/workflows/upstream-watch.yml). It checks configured sources, copies the configured upstream skill and agent trees through vendir and the importer, and creates or updates one catalog PR when content changes. The same PR Checks validate the proposed commit before automatic merge. The `04:00 UTC` release publishes unreleased changes; unchanged nights create no PR or release. Failures remain queued and are reported in one maintenance issue. See [nightly refresh setup](docs/nightly-refresh.md) for source configuration and failure handling.
- This repository does not guess what to monitor.
- It watches only the sources explicitly listed in the upstream watch config surface:
- - [`.github/upstream-watch.json`](.github/upstream-watch.json) for base watch definitions
- - [`.github/upstream-watch*.json`](.github/) for shard files such as `upstream-watch.ai.json` or `upstream-watch-agent-framework.json`
- Those files are the human-maintained source of truth for:
- - GitHub release streams that should trigger skill review
- - documentation pages that should trigger skill review
- - which skills are affected by each upstream change
- - how multiple changed sources map to the same skill refresh
- Each named shard file has exactly two lists:
- - `github_releases`
- - `documentation`
- High-level flow:
- ```mermaid
- flowchart LR
- A["Edit upstream-watch.json or a named upstream-watch.<domain>.json shard"] --> B["Run scripts/upstream_watch.py --validate-config"]
- B --> C["Run dry-run and sync-state-only once"]
- C --> D["00:17 UTC upstream-watch.yml checks configured sources"]
- D --> E["GitHub release or documentation change is detected"]
- E --> F["Changed sources are written to a pending refresh artifact"]
- F --> G["Nightly runner refreshes affected skills and vendir imports"]
- G --> H["Catalog PR passes reusable checks and merges automatically"]
- H --> I["04:00 UTC release pipeline publishes catalog, site, and tool"]
- ```
- Use this shape:
- ```json
- {
- "github_releases": [
- {
- "source": "https://github.com/managedcode/Storage",
- "skills": [
- "managedcode-storage"
- ]
- }
- ],
- "documentation": [
- {
- "source": "https://learn.microsoft.com/dotnet/aspire/",
- "skills": [
- "aspire"
- ]
- }
- ]
- }
- ```
- Keep the base file small and name shard files semantically, for example `upstream-watch.ai.json`, `upstream-watch.data.json`, `upstream-watch.platform.json`, or `upstream-watch-agent-framework.json`.
- That is enough for normal maintenance.
- `scripts/upstream_watch.py` derives the watch kind, ids, source coordinates, display names, and default notes at runtime.
- Use optional fields only when you really need them, for example `match_tag_regex` for mixed release streams or `id` for a stable legacy key.
- If you add a new library or framework and want this repo to keep watching it, the actual how-to is in [CONTRIBUTING.md](CONTRIBUTING.md#upstream-watch-entries).
- ## Contributing
- **This catalog is community-driven.** If you maintain a .NET library, framework, or tool:
- 1. **Add or update a catalog package** under `catalog/<type>/<package>/`
- 2. **Keep package metadata in package `manifest.json`**: title, description, icon, and upstream `links`
- 3. **Keep entity-specific metadata in sibling manifests** such as `catalog/<type>/<package>/skills/<skill>/manifest.json` for `version`, `category`, `packages`, or `package_prefix`
- 4. **Keep implementation guidance in `catalog/<type>/<package>/skills/<skill>/SKILL.md`** and routing behavior in `catalog/<type>/<package>/agents/<agent>/AGENT.md`
- 5. **Add upstream watch** so we know when your project releases updates
- See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide, and use the GitHub contribution templates when opening a package request, maintenance issue, or PR.
- ## Credits
- This catalog builds on the work of many open-source projects and their authors:
- ### Inspiration & Standards
- | Project | Authors | Description |
- |---------|---------|-------------|
- | [MCAF](https://mcaf.managed-code.com/) | Managed Code | Framework for building real software with AI coding agents through repo-native context, verification, `AGENTS.md`, and skills |
- | [dotnet/skills](https://github.com/dotnet/skills) | Microsoft, .NET team | Official .NET skills repository vendir-imported into this catalog for upstream task-specific skills and agents |
- | [withastro/astro](https://github.com/withastro/astro) | Astro Technology Company | Official Astro `astro-developer` skill vendir-imported with pinned source and upstream-change tracking |
- | [webgpu-claude-skill](https://github.com/dgreenheck/webgpu-claude-skill) | Dan Greenheck | Three.js WebGPU and TSL skill vendir-imported with pinned source and upstream-change tracking |
- | [BlazingFastDotnet](https://github.com/EgorBo/BlazingFastDotnet) | Egor Bogatov | .NET performance tuning skill imported verbatim with pinned source and nightly refresh |
- | [Roslynk](https://github.com/mrpmorris/Roslynk) | Peter Morris | Roslyn MCP semantic-navigation and diagnostics skill imported verbatim with pinned source and upstream-change tracking |
- | [Agent Skills Standard](https://agentskills.io) | Anthropic | Open specification for portable agent skill packages |
- | [Claude Code](https://code.claude.com) | Anthropic | Subagent architecture that shaped our orchestration agent design |
- ### Test Frameworks
- | Tool/Library | Authors | License |
- |--------------|---------|---------|
- | [xUnit](https://github.com/xunit/xunit) | Brad Wilson, James Newkirk | Apache-2.0 |
- | [NUnit](https://github.com/nunit/nunit) | Charlie Poole, NUnit team | MIT |
- | [MSTest](https://github.com/microsoft/testfx) | Microsoft | MIT |
- | [TUnit](https://github.com/thomhurst/TUnit) | Tom Longhurst | MIT |
- ### Code Coverage & Mutation Testing
- | Tool/Library | Authors | License |
- |--------------|---------|---------|
- | [Coverlet](https://github.com/coverlet-coverage/coverlet) | Toni Solarin-Sodara, Marco Rossignoli | MIT |
- | [ReportGenerator](https://github.com/danielpalme/ReportGenerator) | Daniel Palme | Apache-2.0 |
- | [Stryker.NET](https://github.com/stryker-mutator/stryker-net) | Stryker Mutator team | Apache-2.0 |
- ### Analyzers & Formatters
- | Tool/Library | Authors | License |
- |--------------|---------|---------|
- | [Roslynator](https://github.com/dotnet/roslynator) | Josef Pihrt, .NET Foundation | Apache-2.0 |
- | [StyleCop.Analyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers) | .NET Analyzers team | MIT |
- | [Meziantou.Analyzer](https://github.com/meziantou/Meziantou.Analyzer) | Gérald Barré | MIT |
- | [CSharpier](https://github.com/belav/csharpier) | Bela VanderVoort | MIT |
- | [ReSharper CLT](https://www.jetbrains.com/resharper/features/command-line.html) | JetBrains | Proprietary (free) |
- ### Architecture Testing
- | Tool/Library | Authors | License |
- |--------------|---------|---------|
- | [NetArchTest](https://github.com/BenMorris/NetArchTest) | Ben Morris | MIT |
- | [ArchUnitNET](https://github.com/TNG/ArchUnitNET) | TNG Technology Consulting | Apache-2.0 |
- ### Metrics & Analysis
- | Tool/Library | Authors | License |
- |--------------|---------|---------|
- | [cloc](https://github.com/AlDanial/cloc) | Al Danial | GPL-2.0 |
- | [CodeQL](https://github.com/github/codeql) | GitHub, Semmle | MIT (queries) |
- | [QuickDup](https://github.com/asynkron/QuickDup) | Roger Johansson, Asynkron | MIT |
- | [Asynkron.Profiler](https://github.com/asynkron/Asynkron.Profiler) | Roger Johansson, Asynkron | MIT |
- ### Frameworks & Libraries
- | Tool/Library | Authors | License |
- |--------------|---------|---------|
- | [CommunityToolkit.Mvvm](https://github.com/CommunityToolkit/dotnet) | Microsoft, .NET Foundation | MIT |
- | [Microsoft Agent Framework](https://github.com/microsoft/agent-framework) | Microsoft | MIT |
- | [Microsoft.Extensions.AI](https://github.com/dotnet/extensions) | Microsoft, .NET Foundation | MIT |
- | [MCP C# SDK](https://github.com/modelcontextprotocol/csharp-sdk) | Anthropic, Microsoft | Apache-2.0 |
- | [Uno Platform](https://github.com/unoplatform/uno) | nventive, Uno Platform | Apache-2.0 |
- | [Orleans](https://github.com/dotnet/orleans) | Microsoft | MIT |
- | [Semantic Kernel](https://github.com/microsoft/semantic-kernel) | Microsoft | MIT |
- | [Entity Framework Core](https://github.com/dotnet/efcore) | Microsoft, .NET Foundation | MIT |
- | [ML.NET](https://github.com/dotnet/machinelearning) | Microsoft, .NET Foundation | MIT |
- | [LibVLCSharp](https://github.com/videolan/libvlcsharp) | VideoLAN | LGPL-2.1 |
- *Want your project credited? Add a skill and include yourself in this list!*
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.