Microsoft .NET Introduces Skill Delivery via NuGet Packages for AI Agents

Summary of the Announcement

On November 3, 2026, Microsoft .NET shared a significant development in AI-driven software development: the delivery of agent skills through NuGet packages. Agent skills, introduced by Anthropic in 2025, provide AI models with up-to-date documentation and guidance to improve task execution. Traditionally distributed via Git repositories, these skills can now be embedded directly within NuGet packages, aligning them alongside the library binaries they document.

What Are Agent Skills and Why NuGet Packages?

Agent skills are structured markdown files (called SKILL.md) containing YAML metadata that instruct AI models on how to use specific libraries or perform tasks related to those libraries. These skills help fill gaps in AI model knowledge and standardize approaches to common tasks.

Delivering these skills through NuGet packages leverages the existing publishing and versioning system for .NET libraries, ensuring that whenever a package is restored locally, its tailored skills are available immediately. This approach benefits developers by providing:

• Just-in-time delivery of the latest documentation and guidance for the exact package version in use.
• Consistency between the library API and the agent’s understanding of it.
• Reduction in overhead for agents, as they can access compiled skill documentation locally without querying external sources extensively.

Key Tools and Workflows Introduced

Microsoft introduced tooling to facilitate skill discovery and usage from NuGet packages, including:

• dotnet-inspect: Allows inspection of packages or project files to discover available embedded skills, displaying details like skill paths, sizes, and descriptions.
• dotnet-package-skills: Enables installing package-provided skills into a repository, making them part of the local project skill set and version-controlled alongside code.

These tools empower developers to evaluate which skills are available and integrate them into AI-assisted workflows.

Who Should Care and Next Steps for Developers

Developers who use AI-assisted coding tools, package maintainers, and teams relying on up-to-date library knowledge for automated agents stand to benefit most from this enhancement.

Maintain maintainers especially need to consider:

• Embedding SKILL.md files in their NuGet packages to provide clear agent guidance.
• Evaluating the efficacy and efficiency impact of skills, as poorly written or excessively verbose skills can increase costs without delivering value.
• Keeping skills updated and consistent with package changes to maximize their benefit.

For developers using AI agents:

• Verify whether NuGet packages used in projects include embedded skills to improve AI assistant performance.
• Consider incorporating the provided tools to explore and manage available skills within your projects.

Potential Challenges and Considerations

While NuGet package delivery of skills offers clear benefits, there are considerations to keep in mind:

• The same skill content applies to all AI models, which may have different capabilities and token costs. Skills must be optimized to provide value efficiently across models.
• Skills must be maintained carefully to avoid increasing usage costs or providing misleading guidance to AI agents.
• Security and trustworthiness remain important; only use packages from trusted maintainers.

Practical Checklist for Developers

1. Check if your NuGet packages contain SKILL.md files using dotnet-inspect.
2. Use dotnet-package-skills to install and incorporate skills into your project’s repositories.
3. Collaborate with package maintainers or your team to create or improve skills for your libraries.
4. Monitor AI agent performance and costs to evaluate skill benefits.
5. Follow updates from Microsoft .NET on best practices and safety guidance related to skill adoption.