Analyzing Dotnet Performance

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.

> [!TIP] > Compare skill value: Open the Skill Value dashboard > 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.
• 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

Agentic Workflows

Reusable GitHub Agentic Workflows are published under agentic-workflows/. Install the complete collection with gh aw add-wizard dotnet/skills/agentic-workflows@main, or install an individual package using the command in its README.

Installation

🚀 Plugins - Copilot CLI / Claude Code

1. Launch Copilot CLI or Claude Code
2. Add the marketplace:

   /plugin marketplace add dotnet/skills

1. Install a plugin:

   /plugin install <plugin>@dotnet-agent-skills

1. Restart to load the new plugins
2. View available skills:

   /skills

1. View available agents:

   /agents

1. 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.

// 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. 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
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 open standard and are compatible with OpenAI Codex.

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. OpenAI Agents SDK 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. 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:

   codex plugin marketplace add dotnet/skills

1. Launch Codex and open the plugin browser:

   /plugins

1. Browse the dotnet-agent-skills tab and install the desired plugins.
2. Update plugins on demand:

   codex plugin marketplace upgrade dotnet-agent-skills

Individual skills

You can also install individual skills using the skill-installer CLI with the GitHub URL:

$ skill-installer install https://github.com/dotnet/skills/tree/main/plugins/<plugin>/skills/<skill-name>

Contributing

See CONTRIBUTING.md for contribution guidelines and how to add a new plugin.

License

See LICENSE for details.