🎯

ln-712-nuget-upgrader

🎯Skill

from levnikolaevich/claude-code-skills

What it does

Automatically upgrades .NET NuGet packages while detecting and handling potential breaking changes across project dependencies.

📦

Part of

levnikolaevich/claude-code-skills(85 items)

ln-712-nuget-upgrader

Installation

Claude CodeAdd plugin in Claude Code

/plugin add levnikolaevich/claude-code-skills

git cloneClone repository

git clone https://github.com/levnikolaevich/claude-code-skills.git ~/.claude/skills

📖 Extracted from docs: levnikolaevich/claude-code-skills

Need more details? View full documentation on GitHub →

13Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Upgrades .NET NuGet packages with breaking change handling

Overview

# ln-712-nuget-upgrader

Type: L3 Worker

Category: 7XX Project Bootstrap

Parent: ln-710-dependency-upgrader

Upgrades .NET NuGet packages with automatic breaking change detection and migration.

---

Overview

| Aspect | Details |

|--------|---------|

| Input | Solution/project path |

| Output | Updated .csproj files, migration report |

| Supports | .NET 6, 7, 8, 9, 10 |

---

Workflow

See [diagram.html](diagram.html) for visual workflow.

Phases: Pre-flight → Find Projects → Security Audit → Check Outdated → Identify Breaking → Apply Upgrades → Restore & Build → Report

---

Phase 0: Pre-flight Checks

| Check | Required | Action if Missing |

|-------|----------|-------------------|

| .csproj file(s) | Yes | Block upgrade |

| .sln file | No | Use csproj discovery instead |

> Workers assume coordinator (ln-710) already verified git state and created backup.

---

Phase 1: Find Projects

Discovery Methods

| Method | Command |

|--------|---------|

| Find .csproj | Get-ChildItem -Recurse -Filter *.csproj |

| From solution | dotnet sln list |

---

Phase 2: Security Audit

Commands

| Check | Command |

|-------|---------|

| Vulnerable packages | dotnet list package --vulnerable |

| Outdated packages | dotnet list package --outdated |

Actions

| Severity | Action |

|----------|--------|

| Critical | Block upgrade, report |

| High | Warn, continue |

| Moderate/Low | Log only |

---

Phase 3: Check Outdated

Using dotnet-outdated

| Step | Command |

|------|---------|

| Install tool | dotnet tool install --global dotnet-outdated-tool |

| Check | dotnet outdated --output json |

---

Phase 4: Identify Breaking Changes

Detection

Compare current vs latest major versions
Check [breaking_changes_patterns.md](../ln-710-dependency-upgrader/references/breaking_changes_patterns.md)
Use MCP tools (see below) for migration guides

Common Breaking Changes

| Package | Breaking Version | Key Changes |

|---------|------------------|-------------|

| Microsoft.EntityFrameworkCore | 8 → 9 | Query changes, migration format |

| Serilog.AspNetCore | 7 → 8 | Configuration format |

| Swashbuckle.AspNetCore | 6 → 7 | Minimal API support |

---

MCP Tools for Migration Search

Priority Order (Fallback Strategy)

| Priority | Tool | When to Use |

|----------|------|-------------|

| 1 | mcp__context7__query-docs | First choice for library docs |

| 2 | mcp__Ref__ref_search_documentation | Official Microsoft docs |

| 3 | WebSearch | Latest info, community solutions |

Context7 Usage

| Step | Tool | Parameters |

|------|------|------------|

| 1. Find library | mcp__context7__resolve-library-id | libraryName: "EntityFrameworkCore" |

| 2. Query docs | mcp__context7__query-docs | query: "EF Core 8 to 9 migration breaking changes" |

MCP Ref Usage

| Action | Tool | Query Example |

|--------|------|---------------|

| Search | mcp__Ref__ref_search_documentation | "dotnet EntityFrameworkCore 9 migration guide" |

| Read | mcp__Ref__ref_read_url | URL from search results |

WebSearch Fallback

Use when Context7/Ref return no results:

" .NET breaking changes migration"
" fix"

---

Phase 5: Apply Upgrades

Priority Order

| Priority | Package Type |

|----------|--------------|

| 1 | SDK/Runtime (Microsoft.NET.Sdk) |

| 2 | Framework (Microsoft.AspNetCore.*) |

| 3 | EF Core (affects migrations) |

| 4 | Logging (Serilog.*) |

| 5 | Other packages |

Commands

| Action | Command |

|--------|---------|

| Update specific | dotnet add package --version |

| Update all | dotnet outdated --upgrade |

---

Phase 6: Restore & Build

Commands

| Step | Command |

|------|---------|

| Restore | dotnet restore |

| Build | dotnet build --configuration Release |

| Test | dotnet test |

On Failure

Identify failing package from error
Search Context7/Ref for migration guide
If unresolved: rollback package, continue

---

Phase 7: Report Results

Report Schema

| Field | Description |

|-------|-------------|

| solution | Solution path |

| projects[] | Updated projects |

| duration | Total time |

| upgrades[] | Applied upgrades |

| buildVerification | PASSED or FAILED |

| testResults | X passed, Y failed |

---

Configuration

```yaml

Options:

# Upgrade scope

upgradeType: major # major | minor | patch

# Security

auditLevel: high

minimumReleaseAge: 14

# .NET specific

includePrerelease: false

targetFramework: net10.0

# Verification

runTests: true

runBuild: true

```

---

Error Handling

| Error | Cause | Solution |

|-------|-------|----------|

| CS0246 | Missing type | Search for replacement API |

| NU1605 | Downgrade detected | Check package constraints |

| Build fail | Breaking change | Apply migration via Context7 |

---

References

[breaking_changes_patterns.md](../ln-710-dependency-upgrader/references/breaking_changes_patterns.md)
[dotnet_version_matrix.md](references/dotnet_version_matrix.md)

---

Version: 1.1.0

Last Updated: 2026-01-10

More from this repository10

🏪

levnikolaevich-claude-code-skills🏪Marketplace

Official marketplace for Agile Linear Workflow plugin - complete end-to-end automation for software development teams using Linear. Includes 7XX Project Bootstrap series for technology-agnostic project migration.

🎯

ln-140-test-docs-creator🎯Skill

Generates comprehensive test documentation with testing strategy and test organization structure for software projects.

🎯

ln-110-project-docs-coordinator🎯Skill

Coordinates project documentation by gathering context once, detecting project type, and delegating document creation to 5 specialized workers.

🎯

ln-114-frontend-docs-creator🎯Skill

Generates design guidelines documentation for frontend projects with WCAG 2.1 compliance when a frontend framework is detected.

🎯

ln-113-backend-docs-creator🎯Skill

Generates backend documentation files (API spec and database schema) automatically when backend or database technologies are detected in a project.

🎯

ln-610-code-comments-auditor🎯Skill

Audits code comments and docstrings across 6 quality categories, generating a comprehensive compliance score and actionable recommendations for improvement.

🎯

ln-115-devops-docs-creator🎯Skill

Generates a comprehensive runbook.md for DevOps setup, dynamically tailored to project's Docker configuration and deployment specifics.

🎯

ln-772-error-handler-setup🎯Skill

Configures global exception handling middleware for .NET and Python backend applications with standardized error responses.

🎯

ln-120-reference-docs-creator🎯Skill

Generates reference documentation structure and smart documents for project tech stack, creating only justified architectural decision records and guides.

🎯

ln-625-dependencies-auditor🎯Skill

Audits dependencies for outdated packages, unused imports, unnecessary libraries, and custom implementations, providing actionable recommendations.