.NET Crash Dump Collection
dotnet/skills
Configures automatic crash dumps or captures dumps from running processes for modern .NET apps on Linux, macOS and Windows, including Docker and Kubernetes.
Manages .NET Docker images including adding images for new .NET versions, new Linux distros (Alpine, Ubuntu, Azure Linux), and new Windows versions.
Install Image Management
$ npx skills add dotnet/dotnet-docker --skill image-management -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dotnet/dotnet-docker image-management --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/dotnet/dotnet-docker.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/image-management .claude/skills/image-management && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "image-management" agent skill from https://github.com/dotnet/dotnet-docker/tree/main/.agents/skills/image-management into .claude/skills/image-management/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "image-management", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/dotnet/dotnet-docker/tree/main/.agents/skills/image-managementType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add dotnet/dotnet-docker --skill image-management -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dotnet/dotnet-docker image-management --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/dotnet-docker.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/image-management .agents/skills/image-management && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "image-management" agent skill from https://github.com/dotnet/dotnet-docker/tree/main/.agents/skills/image-management into .agents/skills/image-management/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "image-management", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dotnet/dotnet-docker --skill image-management -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dotnet/dotnet-docker image-management --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/dotnet-docker.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/image-management .cursor/skills/image-management && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "image-management" agent skill from https://github.com/dotnet/dotnet-docker/tree/main/.agents/skills/image-management into .cursor/skills/image-management/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "image-management", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/dotnet/dotnet-docker.git --path .agents/skills/image-management--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add dotnet/dotnet-docker --skill image-management -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dotnet/dotnet-docker image-management --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/dotnet-docker.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/image-management .gemini/skills/image-management && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "image-management" agent skill from https://github.com/dotnet/dotnet-docker/tree/main/.agents/skills/image-management into .gemini/skills/image-management/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "image-management", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install dotnet/dotnet-docker image-managementInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add dotnet/dotnet-docker --skill image-management -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/dotnet/dotnet-docker.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/image-management .github/skills/image-management && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "image-management" agent skill from https://github.com/dotnet/dotnet-docker/tree/main/.agents/skills/image-management into .github/skills/image-management/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "image-management", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dotnet/dotnet-docker --skill image-management -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install dotnet/dotnet-docker image-management --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/dotnet-docker.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/image-management .opencode/skills/image-management && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "image-management" agent skill from https://github.com/dotnet/dotnet-docker/tree/main/.agents/skills/image-management into .opencode/skills/image-management/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "image-management", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
image-management- GitHub stars
- 4.9k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 475 words
- Files
- 1
- Skills in repo
- 5
- Repo updated
- First seen
- Licence
- MIT
At a glance
Manages .NET Docker images including adding images for new .NET versions, new Linux distros (Alpine, Ubuntu, Azure Linux), and new Windows versions.
- Works in 5 steps: Gather requirements → Update Dockerfiles and manifests → Update READMEs → …
- Tasks that involve Containers
- SKILL.md covers Workflow: Adding new images and Workflow: Removing images
- Calls pwsh
What it does
Image Management is an agent skill from dotnet/dotnet-docker, published by the product's own GitHub organization. Manages .NET Docker images including adding images for new .NET versions, new Linux distros (Alpine, Ubuntu, Azure Linux), and new Windows versions. Handles Dockerfile templates, manifest updates, test data, and README generation.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Containers and Test data and fixtures. It works with .NET, Docker, Linux and Microsoft Azure. The repository describes itself as: Official container images for .NET. The licence is MIT.
When your agent uses it
- Tasks that involve Containers
- Tasks that involve Test data and fixtures
Example prompts
- “Use the image-management skill to manage .NET Docker images including adding images for new .NET versions, new Linux distros (Alpine, Ubuntu, Azure…”
- “/image-management”
Requirements
- Docker
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 3eaedc9. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
pwsh
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Image Management loads about 1.1k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 475 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from dotnet/dotnet-docker at commit 3eaedc9, republished under its MIT licence (© dotnet). 475 words, ~1,053 tokens.
Download SKILL.mdSave it as
.claude/skills/image-management/SKILL.md (or your agent's skills folder).- name
- image-management
- description
- Manages .NET Docker images including adding images for new .NET versions, new Linux distros (Alpine, Ubuntu, Azure Linux), and new Windows versions. Handles Dockerfile templates, manifest updates, test data, and README generation.
Image management
Your job is to help manage the images in the dotnet-docker repo. Follow the below policies when adding or removing images:
- Supported platforms policy - describes which OS versions should be added/supported and when.
- Supported tags policy - describes tagging patterns to follow when adding new images.
- Contributor guide - describes common workflows for making edits in this repo.
Workflow: Adding new images
Step 1: Gather requirements
- Identify the new .NET version, Linux distro, or Windows version to be added.
- Which .NET versions should be supported?
- Which OS versions should be added?
- Which architectures should be supported?
Step 2: Update Dockerfiles and manifests
- Make copies of the Dockerfiles for the most recent version of the new OS or .NET version. The content does not matter since the files will be updated by templates later.
- Add entries to
manifest.versions.jsonfor the new OS or .NET versions if needed. Follow the existing patterns in the file.- If adding a new .NET version, ensure that minor version tags have a "-preview" suffix (for example,
"dotnet|10.0|minor-tag": "10.0-preview")
- If adding a new .NET version, ensure that minor version tags have a "-preview" suffix (for example,
- If necessary, create new templates for Dockerfiles under
eng/dockerfile-templates.- This is typically only needed for new product variants. New OSes or .NET versions do not usually require template changes.
- Add entries to
manifest.jsonfor the new images.- Copy the entries from the most recent version of the new OS or .NET version and update tags/versions/Dockerfile/template references as appropriate.
- Generate the Dockerfiles from the templates:
- Run
pwsh ./eng/dockerfile-templates/Get-GeneratedDockerfiles.ps1. - If there are any issues with template generation, fix them in the templates or manifest entries and re-run the command.
- Inspect the generated Dockerfiles for correctness and update
manifest.json,manifest.versions.json, and Dockerfile templates as needed.
- Run
Show full SKILL.md (196 more words)Show less
Step 3. Update READMEs
- Update the MCR tags metadata templates to include references to the new images.
- Follow the existing patterns/orderings in the files.
- Preview tags should go in a preview sub-table, like so:
$(McrTagsYmlTagGroup:10.0-preview-noble|.NET 10 Preview Tags)
- Update readme templates under
eng/readme-templatesto include the new OS or .NET version if necessary. - Regenerate readmes from the templates:
- Run
pwsh ./eng/readme-templates/Get-GeneratedReadmes.ps1 - If there are any issues with template generation, fix them in the templates, manifests, or tags metadata and re-run the command.
- Inspect the updated readme files for correctness.
- Run
Step 4: Update tests
- Update the TestData.cs to include the new distro version
- Update internal Dockerfile baselines:
- Run
pwsh ./tests/update-internal-baselines.ps1to regenerate and accept baseline files. - Commit the updated baseline files.
- Run
- Ensure pre-build validation tests pass:
pwsh ./tests/run-tests.ps1 -Paths "*" -TestCategories "pre-build"
Step 5: Keep this document up-to-date
Update this document with any changes to the image management process that you notice while adding or removing images.
Workflow: Removing images
Follow instructions for adding new images in reverse. In addition, search for and update references to the removed .NET version/OS version in the following places:
© dotnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/image-management of dotnet/dotnet-docker.
Open the folder on GitHubat commit 3eaedc9
Compare with similar skills
Image Management next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Image Management this skilldotnet/dotnet-docker | 4.9k | — | ~1.1k | Automated safety check: Pass | MIT | |
| .NET Crash Dump Collectiondotnet/skills | 5.6k | 2 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Build Imageskubernetes-sigs/cloud-provider-azure | 294 | — | ~1.7k | Automated safety check: Pass | Apache-2.0 | |
| Ama Logs Update Charts Release Notesmicrosoft/Docker-Provider | 173 | — | ~2.6k | Automated safety check: Pass | Custom licence | |
| Containerize Aspnetcoregithub/awesome-copilot | 40k | 1 repos | ~4k | Automated safety check: Warn | MIT | |
| Azure App Onboard Prereqmicrosoft/GitHub-Copilot-for-Azure | 255 | — | ~2.5k | Automated safety check: Pass | MIT |
Similar skills
- Official
- Official
Build Images
kubernetes-sigs/cloud-provider-azure
Build cloud-provider-azure container images through the repo Makefile with explicit IMAGETAG and IMAGEREGISTRY inputs, optional make flag overrides, and opt-in bounded Docker or Podman retries.
- Official
Ama Logs Update Charts Release Notes
microsoft/Docker-Provider
Prepare an ama-logs release PR: bump the image tag (X.Y.Z) across Helm charts, manifests, and Dockerfiles, and add a formatted ReleaseNotes.md entry.
- Official
Containerize Aspnetcore
github/awesome-copilot
Containerize an ASP.NET Core project by creating Dockerfile and .dockerfile files customized for the project.
- Official
Azure App Onboard Prereq
microsoft/GitHub-Copilot-for-Azure
Assess whether source code is ready to deploy to Azure — the check BEFORE infrastructure work.
Dotnet Debugging
novotnyllc/dotnet-artisan
Debugs Windows and Linux/macOS applications (native, .NET/CLR, mixed-mode) with WinDbg MCP (crash dumps, !analyze, !syncblk, !dlk, !runaway, !dumpheap, !gcroot, BSOD), dotnet-dump, lldb with SOS…
More from dotnet/dotnet-docker
- Official
Dockerfile And Readme Templating
dotnet/dotnet-docker
Modify Cottle templates that generate Dockerfiles and READMEs in dotnet/dotnet-docker.
- Official
Porting Changes
dotnet/dotnet-docker
Plan and move changes between branches in dotnet/dotnet-docker.
- Official
Resolving Conflicts
dotnet/dotnet-docker
A skill your agent uses when merging or cherry-picking changes cause git conflicts.
- Official
Merge Main To Nightly
dotnet/dotnet-docker
Create a PR to merge main into the nightly branch after a .NET containers release.
Related
Works with
Categories
Questions about Image Management
What does Image Management do?
Manages .NET Docker images including adding images for new .NET versions, new Linux distros (Alpine, Ubuntu, Azure Linux), and new Windows versions. Image Management is an agent skill from dotnet/dotnet-docker, published by the product's own GitHub organization.NET versions, new Linux distros (Alpine, Ubuntu, Azure Linux), and new Windows versions.
When should I use Image Management?
Image Management fits situations like: tasks that involve Containers; tasks that involve Test data and fixtures.
How do I install Image Management in Claude Code?
Run `npx skills add dotnet/dotnet-docker --skill image-management -a claude-code`. Or copy the skill folder (.agents/skills/image-management in dotnet/dotnet-docker) into .claude/skills/image-management in your project. Claude Code loads it when a task matches its description.
How do I install Image Management in Codex?
Run `npx skills add dotnet/dotnet-docker --skill image-management -a codex`. Or copy the skill folder (.agents/skills/image-management in dotnet/dotnet-docker) into .agents/skills/image-management in your project. Codex loads it when a task matches its description.
Can I use Image Management in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dotnet/dotnet-docker --skill image-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/image-management, .gemini/skills/image-management, .github/skills/image-management and .opencode/skills/image-management in your project.
What does Image Management need to run?
Going by SKILL.md and its folder, Image Management needs the command-line tools its instructions call (pwsh). Our summary lists: Docker.
Does Image Management access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Image Management safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Image Management use?
Image Management is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Image Management use?
About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Image Management?
Skills that share tags, products or a category with Image Management: .NET Crash Dump Collection (dotnet/skills, 5.6k stars), Build Images (kubernetes-sigs/cloud-provider-azure, 294 stars), Ama Logs Update Charts Release Notes (microsoft/Docker-Provider, 173 stars) and Containerize Aspnetcore (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Image Management?
dotnet (a GitHub organization, an official publisher) maintains it in dotnet/dotnet-docker, which has 4,874 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.
Source: dotnet/dotnet-docker on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.