package-management

Name: package-management
Author: Aaronontheweb

430installs98forks

How to install package-management?

aaronontheweb/dotnet-skills/package-management

$npx -y skills add Aaronontheweb/dotnet-skills --skill package-management

Installs into the current project.

Summary

Manage NuGet packages using Central Package Management (CPM) and dotnet CLI commands. Never edit XML directly - use dotnet add/remove/list commands. Use shared version variables for related packages.

Files · 1

View on GitHub

SKILL.md

1	# NuGet Package Management
2
3	## When to Use This Skill
4
5	Use this skill when:
6	- Adding, removing, or updating NuGet packages
7	- Setting up Central Package Management (CPM) for a solution
8	- Managing package versions across multiple projects
9	- Troubleshooting package conflicts or restore issues
10
11	---
12
13	## Golden Rule: Never Edit XML Directly
14
15	Always use `dotnet` CLI commands to manage packages. Never manually edit `.csproj` or `Directory.Packages.props` files.
16
17	```bash
18	# DO: Use CLI commands
19	dotnet add package Newtonsoft.Json
20	dotnet remove package Newtonsoft.Json
21	dotnet list package --outdated
22
23	# DON'T: Edit XML directly
24	# <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
25	```
26
27	Why:
28	- CLI validates package exists and resolves correct version
29	- Handles transitive dependencies correctly
30	- Updates lock files if present
31	- Avoids typos and malformed XML
32	- Works correctly with CPM
33
34	---
35
36	## Central Package Management (CPM)
37
38	CPM centralizes all package versions in one file, eliminating version conflicts across projects.
39
40	### Enable CPM
41
42	Create `Directory.Packages.props` in solution root:
43
44	```xml
45	<Project>
46	<PropertyGroup>
47	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
48	</PropertyGroup>
49
50	<ItemGroup>
51	<PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
52	<PackageVersion Include="Serilog" Version="4.0.0" />
53	<PackageVersion Include="xunit" Version="2.9.2" />
54	</ItemGroup>
55	</Project>
56	```
57
58	### Project Files with CPM
59
60	Projects reference packages without versions:
61
62	```xml
63	<!-- src/MyApp/MyApp.csproj -->
64	<Project Sdk="Microsoft.NET.Sdk">
65	<ItemGroup>
66	<PackageReference Include="Newtonsoft.Json" />
67	<PackageReference Include="Serilog" />
68	</ItemGroup>
69	</Project>
70	```
71
72	### Adding Packages with CPM
73
74	```bash
75	# Adds to Directory.Packages.props AND project file
76	dotnet add package Serilog.Sinks.Console
77
78	# Result in Directory.Packages.props:
79	# <PackageVersion Include="Serilog.Sinks.Console" Version="6.0.0" />
80
81	# Result in project file:
82	# <PackageReference Include="Serilog.Sinks.Console" />
83	```
84
85	---
86
87	## Shared Version Variables
88
89	Group related packages with shared version variables:
90
91	```xml
92	<Project>
93	<PropertyGroup>
94	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
95	</PropertyGroup>
96
97	<!-- Shared version variables -->
98	<PropertyGroup Label="SharedVersions">
99	<AkkaVersion>1.5.59</AkkaVersion>
100	<AkkaHostingVersion>1.5.59</AkkaHostingVersion>
101	<AspireVersion>9.0.0</AspireVersion>
102	<OpenTelemetryVersion>1.11.0</OpenTelemetryVersion>
103	<XunitVersion>2.9.2</XunitVersion>
104	</PropertyGroup>
105
106	<!-- Akka.NET packages - all use same version -->
107	<ItemGroup Label="Akka.NET">
108	<PackageVersion Include="Akka" Version="$(AkkaVersion)" />
109	<PackageVersion Include="Akka.Cluster" Version="$(AkkaVersion)" />
110	<PackageVersion Include="Akka.Cluster.Sharding" Version="$(AkkaVersion)" />
111	<PackageVersion Include="Akka.Cluster.Tools" Version="$(AkkaVersion)" />
112	<PackageVersion Include="Akka.Persistence" Version="$(AkkaVersion)" />
113	<PackageVersion Include="Akka.Streams" Version="$(AkkaVersion)" />
114	<PackageVersion Include="Akka.Hosting" Version="$(AkkaHostingVersion)" />
115	<PackageVersion Include="Akka.Cluster.Hosting" Version="$(AkkaHostingVersion)" />
116	</ItemGroup>
117
118	<!-- Aspire packages -->
119	<ItemGroup Label="Aspire">
120	<PackageVersion Include="Aspire.Hosting" Version="$(AspireVersion)" />
121	<PackageVersion Include="Aspire.Hosting.AppHost" Version="$(AspireVersion)" />
122	<PackageVersion Include="Aspire.Hosting.PostgreSQL" Version="$(AspireVersion)" />
123	<PackageVersion Include="Aspire.Hosting.Testing" Version="$(AspireVersion)" />
124	</ItemGroup>
125
126	<!-- OpenTelemetry packages -->
127	<ItemGroup Label="OpenTelemetry">
128	<PackageVersion Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="$(OpenTelemetryVersion)" />
129	<PackageVersion Include="OpenTelemetry.Extensions.Hosting" Version="$(OpenTelemetryVersion)" />
130	<PackageVersion Include="OpenTelemetry.Instrumentation.AspNetCore" Version="$(OpenTelemetryVersion)" />
131	<PackageVersion Include="OpenTelemetry.Instrumentation.Http" Version="$(OpenTelemetryVersion)" />
132	</ItemGroup>
133
134	<!-- Testing -->
135	<ItemGroup Label="Testing">
136	<PackageVersion Include="xunit" Version="$(XunitVersion)" />
137	<PackageVersion Include="xunit.runner.visualstudio" Version="$(XunitVersion)" />
138	<PackageVersion Include="FluentAssertions" Version="6.12.0" />
139	<PackageVersion Include="Verify.Xunit" Version="26.0.0" />
140	</ItemGroup>
141	</Project>
142	```
143
144	Benefits:
145	- Update all Akka packages by changing one variable
146	- Clear organization with labeled ItemGroups
147	- Prevents version mismatches in rel

People who liked this also viewed

6 picks

Type

package-management

430installs98forks

View on GitHub

How to install package-management?

aaronontheweb/dotnet-skills/package-management

$npx -y skills add Aaronontheweb/dotnet-skills --skill package-management

Installs into the current project.

Summary

Manage NuGet packages using Central Package Management (CPM) and dotnet CLI commands. Never edit XML directly - use dotnet add/remove/list commands. Use shared version variables for related packages.

Files · 1

View on GitHub

SKILL.md

1	# NuGet Package Management
2
3	## When to Use This Skill
4
5	Use this skill when:
6	- Adding, removing, or updating NuGet packages
7	- Setting up Central Package Management (CPM) for a solution
8	- Managing package versions across multiple projects
9	- Troubleshooting package conflicts or restore issues
10
11	---
12
13	## Golden Rule: Never Edit XML Directly
14
15	Always use `dotnet` CLI commands to manage packages. Never manually edit `.csproj` or `Directory.Packages.props` files.
16
17	```bash
18	# DO: Use CLI commands
19	dotnet add package Newtonsoft.Json
20	dotnet remove package Newtonsoft.Json
21	dotnet list package --outdated
22
23	# DON'T: Edit XML directly
24	# <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
25	```
26
27	Why:
28	- CLI validates package exists and resolves correct version
29	- Handles transitive dependencies correctly
30	- Updates lock files if present
31	- Avoids typos and malformed XML
32	- Works correctly with CPM
33
34	---
35
36	## Central Package Management (CPM)
37
38	CPM centralizes all package versions in one file, eliminating version conflicts across projects.
39
40	### Enable CPM
41
42	Create `Directory.Packages.props` in solution root:
43
44	```xml
45	<Project>
46	<PropertyGroup>
47	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
48	</PropertyGroup>
49
50	<ItemGroup>
51	<PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
52	<PackageVersion Include="Serilog" Version="4.0.0" />
53	<PackageVersion Include="xunit" Version="2.9.2" />
54	</ItemGroup>
55	</Project>
56	```
57
58	### Project Files with CPM
59
60	Projects reference packages without versions:
61
62	```xml
63	<!-- src/MyApp/MyApp.csproj -->
64	<Project Sdk="Microsoft.NET.Sdk">
65	<ItemGroup>
66	<PackageReference Include="Newtonsoft.Json" />
67	<PackageReference Include="Serilog" />
68	</ItemGroup>
69	</Project>
70	```
71
72	### Adding Packages with CPM
73
74	```bash
75	# Adds to Directory.Packages.props AND project file
76	dotnet add package Serilog.Sinks.Console
77
78	# Result in Directory.Packages.props:
79	# <PackageVersion Include="Serilog.Sinks.Console" Version="6.0.0" />
80
81	# Result in project file:
82	# <PackageReference Include="Serilog.Sinks.Console" />
83	```
84
85	---
86
87	## Shared Version Variables
88
89	Group related packages with shared version variables:
90
91	```xml
92	<Project>
93	<PropertyGroup>
94	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
95	</PropertyGroup>
96
97	<!-- Shared version variables -->
98	<PropertyGroup Label="SharedVersions">
99	<AkkaVersion>1.5.59</AkkaVersion>
100	<AkkaHostingVersion>1.5.59</AkkaHostingVersion>
101	<AspireVersion>9.0.0</AspireVersion>
102	<OpenTelemetryVersion>1.11.0</OpenTelemetryVersion>
103	<XunitVersion>2.9.2</XunitVersion>
104	</PropertyGroup>
105
106	<!-- Akka.NET packages - all use same version -->
107	<ItemGroup Label="Akka.NET">
108	<PackageVersion Include="Akka" Version="$(AkkaVersion)" />
109	<PackageVersion Include="Akka.Cluster" Version="$(AkkaVersion)" />
110	<PackageVersion Include="Akka.Cluster.Sharding" Version="$(AkkaVersion)" />
111	<PackageVersion Include="Akka.Cluster.Tools" Version="$(AkkaVersion)" />
112	<PackageVersion Include="Akka.Persistence" Version="$(AkkaVersion)" />
113	<PackageVersion Include="Akka.Streams" Version="$(AkkaVersion)" />
114	<PackageVersion Include="Akka.Hosting" Version="$(AkkaHostingVersion)" />
115	<PackageVersion Include="Akka.Cluster.Hosting" Version="$(AkkaHostingVersion)" />
116	</ItemGroup>
117
118	<!-- Aspire packages -->
119	<ItemGroup Label="Aspire">
120	<PackageVersion Include="Aspire.Hosting" Version="$(AspireVersion)" />
121	<PackageVersion Include="Aspire.Hosting.AppHost" Version="$(AspireVersion)" />
122	<PackageVersion Include="Aspire.Hosting.PostgreSQL" Version="$(AspireVersion)" />
123	<PackageVersion Include="Aspire.Hosting.Testing" Version="$(AspireVersion)" />
124	</ItemGroup>
125
126	<!-- OpenTelemetry packages -->
127	<ItemGroup Label="OpenTelemetry">
128	<PackageVersion Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="$(OpenTelemetryVersion)" />
129	<PackageVersion Include="OpenTelemetry.Extensions.Hosting" Version="$(OpenTelemetryVersion)" />
130	<PackageVersion Include="OpenTelemetry.Instrumentation.AspNetCore" Version="$(OpenTelemetryVersion)" />
131	<PackageVersion Include="OpenTelemetry.Instrumentation.Http" Version="$(OpenTelemetryVersion)" />
132	</ItemGroup>
133
134	<!-- Testing -->
135	<ItemGroup Label="Testing">
136	<PackageVersion Include="xunit" Version="$(XunitVersion)" />
137	<PackageVersion Include="xunit.runner.visualstudio" Version="$(XunitVersion)" />
138	<PackageVersion Include="FluentAssertions" Version="6.12.0" />
139	<PackageVersion Include="Verify.Xunit" Version="26.0.0" />
140	</ItemGroup>
141	</Project>
142	```
143
144	Benefits:
145	- Update all Akka packages by changing one variable
146	- Clear organization with labeled ItemGroups
147	- Prevents version mismatches in rel

People who liked this also viewed

6 picks

Type