setup-local-sdk

npx skills add dotnet/skills --skill setup-local-sdk --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# setup-local-sdk ## Purpose Guide the user through installing a .NET SDK into a project-local `.dotnet/` directory and wiring it up via the `global.json` `paths` feature (.NET 10+). The examples use .NET 11, but this works with any version — prerelease or stable. The result is a fully isolated SDK that: - Does **not** modify the system-wide .NET installation. - Is picked up automatically by `dotnet` commands from the project root. - Can be deleted to revert (`rm -rf .dotnet/` or `Remove-Item -Recurse -Force .\.dotnet`). ## When NOT to use - User wants a **system-wide** install — direct to the official installer. - Host `dotnet` is **older than v10** — `paths` doesn't exist; explain and stop. - User needs a **runtime-only** install — `paths` applies to SDK resolution only. ## Inputs / Prerequisites | Input | Required | Default | Notes | |---|---|---|---| | Channel or version | No | `11.0` | e.g. `11.0`, `STS`, `LTS`, or an exact version like `11.0.100-preview.2.26159.112` | | Quality | No | `preview` | One of: `daily`, `preview`, `ga` | | jq | No | — | Optional for bash team scripts when patching an existing `global.json`; without it, do not overwrite the file | ### Prerequisites 1

dotnet --version
test -d .dotnet && echo "exists" || echo "not found"
trap 'rm -f "$INSTALL_SCRIPT"' EXIT
curl -fsSL https://dot.net/v1/dotnet-install.sh -o "$INSTALL_SCRIPT"
bash "$INSTALL_SCRIPT" --channel <CHANNEL> --quality <QUALITY> --install-dir .dotnet
grep -qxF '.dotnet/' .gitignore 2>/dev/null || printf '\n.dotnet/\n' >> .gitignore
set -euo pipefail
rm -f "$INSTALL_SCRIPT"
trap cleanup EXIT
if [ -n "$VERSION" ]; then