# Dotnet Sdk Align

> Align .NET SDK pinning (`global.json` + CI references) and validate restore/build/test impact in a gated workflow.

- Skill: `nickcuypers/dotnet-sdk-align` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add nickcuypers/dotnet-sdk-align`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nickcuypers/dotnet-sdk-align/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: nickcuypers (https://skillmd.com/u/nickcuypers)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/nickcuypers/dotnet-sdk-align

---


## When to use / when NOT to use
- Use to standardize SDK versions and avoid local/CI drift.
- Do not use for package-version upgrades (use package workflow skill).

## Preconditions (tools, versions, repo state)
- `dotnet` CLI installed.
- Repo contains .NET files (`*.sln`, `*.csproj`, or props files).
- Clean git state before `--execute`.

## Workflow (DISCOVER → PLAN → EXECUTE → VERIFY → REPORT)
1. DISCOVER: inspect SDK pinning and CI hints.
2. PLAN: define target SDK and expected impact.
3. EXECUTE: update/create `global.json` for target SDK.
4. VERIFY: run restore/build/test.
5. REPORT: summarize alignment status and remaining CI actions.

## Exact commands and expected signals
```bash
skills/dotnet-sdk-align/scripts/run.sh --dry-run
skills/dotnet-sdk-align/scripts/run.sh --execute --sdk=8.0.204 --ci
skills/dotnet-sdk-align/scripts/run.sh --verify-only --ci
```
Success: `global.json` reflects target SDK (execute) and restore/build/test complete.
Failure: missing `dotnet`, dirty tree, or omitted `--sdk` in execute mode.

## If it fails (checklist)
- Install required .NET SDK locally.
- Verify SDK version exists (`dotnet --list-sdks`).
- Reconcile CI image/toolset with selected SDK.

## Final report template
- Current vs target SDK.
- Files touched (`global.json`, CI references).
- Restore/build/test results.
- CI changes needed.
- Rollback command.