mirror of
https://github.com/dotnet/skills.git
synced 2026-09-20 09:49:54 +08:00
Amaury Levé
460a01882f
* fix: validate native Codex plugin support Separate Codex-compatible plugin components from GitHub Copilot custom agents, validate Codex manifest fields and MCP shapes, and document the native agent installation boundary. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * fix: strengthen Codex plugin verification Validate Codex MCP per-tool settings and add a pinned native smoke lane that installs the marketplace, discovers skills and MCP, and calls binlog_overview. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * fix: avoid restarting Codex MCP smoke client Use the real tool call as the app-server initialization so the Linux smoke test does not start and tear down a redundant status client first. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * fix: harden Codex validation and smoke cleanup Constrain smoke artifacts to a dedicated child directory, validate Codex manifest field shapes and required skill paths, and document the separate Agents SDK handoff model. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * fix: align Codex smoke and hooks parsing Use the clean Codex installation's default provider for the direct MCP call and reject heterogeneous hooks arrays like the runtime parser. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * fix: verify every Codex plugin skill Compare native skill discovery with the full repository inventory, match Codex lexical path rejection, and allow null optional MCP tool settings. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * fix: address Codex compatibility review Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
147 lines
6.7 KiB
Markdown
147 lines
6.7 KiB
Markdown
# .NET Agent Skills
|
|
|
|
[](https://dotnet.github.io/skills/)
|
|
|
|
This repository contains the .NET team's curated set of portable skills and host-specific custom
|
|
agents for coding agents. For information about the Agent Skills standard, see
|
|
[agentskills.io](https://agentskills.io).
|
|
|
|
> [!TIP]
|
|
> **Compare skill value:** [Open the Skill Value dashboard](https://dotnet.github.io/skills/)
|
|
> See token use, elapsed time, activation, and not-passed rates by plugin, skill,
|
|
> executor model, and judge model.
|
|
|
|
Plugin support is component-specific:
|
|
|
|
- Skills and MCP servers are the portable component types defined by
|
|
[Agent Plugins 1.0](https://agent-plugins.org/specification).
|
|
- Files under `agents/*.agent.md` use GitHub Copilot custom-agent conventions. They are not
|
|
installed as native OpenAI Codex agents.
|
|
- Native Codex agents use `.codex/agents/*.toml`. This repository does not currently ship them
|
|
because Codex plugin installation does not place agent files in those discovery locations.
|
|
|
|
## What's Included
|
|
|
|
| Plugin | Description |
|
|
|--------|-------------|
|
|
| [dotnet](plugins/dotnet/) | High-level .NET development skills plus C# language server (LSP) integration for hosts that support it. |
|
|
| [dotnet-advanced](plugins/dotnet-advanced/) | Collection of .NET skills for handling specific .NET tasks for special scenarios. |
|
|
| [dotnet-data](plugins/dotnet-data/) | Skills for .NET data access and Entity Framework related tasks. |
|
|
| [dotnet-diag](plugins/dotnet-diag/) | Skills for .NET performance investigations, debugging, and incident analysis. |
|
|
| [dotnet-msbuild](plugins/dotnet-msbuild/) | Comprehensive MSBuild and .NET build skills: failure diagnosis, performance optimization, code quality, and modernization. |
|
|
| [dotnet-nuget](plugins/dotnet-nuget/) | NuGet and .NET package management: dependency management and modernization. |
|
|
| [dotnet-upgrade](plugins/dotnet-upgrade/) | Skills for migrating and upgrading .NET projects across framework versions, language features, and compatibility targets. |
|
|
| [dotnet-maui](plugins/dotnet-maui/) | Skills for .NET MAUI development: environment setup, diagnostics, and troubleshooting. |
|
|
| [dotnet-ai](plugins/dotnet-ai/) | AI and ML skills for .NET: technology selection, LLM integration, agentic workflows, RAG pipelines, MCP, and classic ML with ML.NET. |
|
|
| [dotnet-template-engine](plugins/dotnet-template-engine/) | .NET Template Engine skills: template discovery, project scaffolding, and template authoring. |
|
|
| [dotnet-test](plugins/dotnet-test/) | Skills for running, generating, analyzing, and improving .NET tests: test execution, filtering, platform detection, coverage, testability, and MSTest workflows. |
|
|
| [dotnet-test-migration](plugins/dotnet-test-migration/) | Skills and a GitHub Copilot orchestrator agent for migrating .NET test frameworks and platforms: MSTest and xUnit version upgrades, xUnit-to-MSTest conversion, and VSTest to Microsoft.Testing.Platform. |
|
|
| [dotnet-aspnetcore](plugins/dotnet-aspnetcore/) | ASP.NET Core web development skills including middleware, endpoints, real-time communication, and API patterns. |
|
|
| [dotnet-blazor](plugins/dotnet-blazor/) | Skills for Blazor development: component authoring, interactivity, and web application patterns. |
|
|
| [dotnet11](plugins/dotnet11/) | Skills for new .NET 11 APIs and language features. |
|
|
|
|
## Installation
|
|
|
|
### 🚀 Plugins - Copilot CLI / Claude Code
|
|
|
|
1. Launch Copilot CLI or Claude Code
|
|
2. Add the marketplace:
|
|
```
|
|
/plugin marketplace add dotnet/skills
|
|
```
|
|
3. Install a plugin:
|
|
```
|
|
/plugin install <plugin>@dotnet-agent-skills
|
|
```
|
|
4. Restart to load the new plugins
|
|
5. View available skills:
|
|
```
|
|
/skills
|
|
```
|
|
6. View available agents:
|
|
```
|
|
/agents
|
|
```
|
|
7. Update plugin (on demand):
|
|
```
|
|
/plugin update <plugin>@dotnet-agent-skills
|
|
```
|
|
|
|
### VS Code / VS Code Insiders (Preview)
|
|
|
|
> [!IMPORTANT]
|
|
> VS Code plugin support is a preview feature and subject to change. You may need to enable it first.
|
|
|
|
```jsonc
|
|
// settings.json
|
|
{
|
|
"chat.plugins.enabled": true,
|
|
"chat.plugins.marketplaces": ["dotnet/skills"]
|
|
}
|
|
```
|
|
|
|
Once configured, type `/plugins` in Copilot Chat or use the `@agentPlugins` filter in Extensions to browse and install plugins from the marketplace.
|
|
|
|
### Cursor
|
|
|
|
This repository is a [Cursor plugin marketplace](https://cursor.com/docs/plugins). You can discover and install published plugins directly in Cursor:
|
|
|
|
1. Open the marketplace panel in Cursor
|
|
2. Search for `.NET` or browse [cursor.com/marketplace](https://cursor.com/marketplace)
|
|
3. Install the desired plugins
|
|
|
|
For local development or unpublished changes, import plugins from a local checkout:
|
|
|
|
1. Copy or symlink your local checkout to `~/.cursor/plugins/local/dotnet-agent-skills`
|
|
2. Restart Cursor or run **Developer: Reload Window**
|
|
|
|
### Codex CLI
|
|
|
|
Skills in this repository follow the [agentskills.io](https://agentskills.io) open standard
|
|
and are compatible with [OpenAI Codex](https://developers.openai.com/codex/skills).
|
|
|
|
Codex plugin installs expose the skills and any Codex-compatible MCP servers declared by the
|
|
plugin. They do not expose the repository's GitHub Copilot `.agent.md` files, their static
|
|
handoffs, or host-specific LSP declarations. Use Codex's built-in dynamic subagent delegation
|
|
instead. Native Codex custom agents are a separate configuration mechanism documented under
|
|
[multi-agent workflows](https://developers.openai.com/codex/multi-agent/). OpenAI
|
|
[Agents SDK handoffs](https://openai.github.io/openai-agents-python/handoffs/) are an
|
|
application-level transfer between SDK-defined agents; they are separate from both Copilot's
|
|
static UI handoff metadata and Codex plugin or custom-agent packaging.
|
|
|
|
#### Plugin marketplace (recommended)
|
|
|
|
Codex CLI v0.121.0 and later supports a [plugin marketplace](https://developers.openai.com/codex/plugins).
|
|
This repository ships a Codex-native marketplace manifest at `.agents/plugins/marketplace.json`,
|
|
so you can register `dotnet/skills` as a marketplace and install plugins from it directly.
|
|
|
|
1. Add the marketplace:
|
|
```bash
|
|
codex plugin marketplace add dotnet/skills
|
|
```
|
|
2. Launch Codex and open the plugin browser:
|
|
```
|
|
/plugins
|
|
```
|
|
3. Browse the `dotnet-agent-skills` tab and install the desired plugins.
|
|
4. Update plugins on demand:
|
|
```bash
|
|
codex plugin marketplace upgrade dotnet-agent-skills
|
|
```
|
|
|
|
#### Individual skills
|
|
|
|
You can also install individual skills using the `skill-installer` CLI with the GitHub URL:
|
|
|
|
```bash
|
|
$ skill-installer install https://github.com/dotnet/skills/tree/main/plugins/<plugin>/skills/<skill-name>
|
|
```
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines and how to add a new plugin.
|
|
|
|
## License
|
|
|
|
See [LICENSE](LICENSE) for details.
|