MAUI PR Performance Analysis
dotnet/maui
Interprets pinned managed benchmark evidence for a dotnet/maui pull request and writes a narrative for the performance review workflow, without running or publishing anything.
Reviews or updates repository documentation as a dedicated task after implementation is complete.
Install Docs Maintenance
$ npx skills add dotnet/docker-tools --skill docs-maintenance -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dotnet/docker-tools docs-maintenance --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/docker-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/docs-maintenance .claude/skills/docs-maintenance && 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 "docs-maintenance" agent skill from https://github.com/dotnet/docker-tools/tree/main/.github/skills/docs-maintenance into .claude/skills/docs-maintenance/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-maintenance", 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/docker-tools/tree/main/.github/skills/docs-maintenanceType 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/docker-tools --skill docs-maintenance -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dotnet/docker-tools docs-maintenance --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/docker-tools.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/docs-maintenance .agents/skills/docs-maintenance && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "docs-maintenance" agent skill from https://github.com/dotnet/docker-tools/tree/main/.github/skills/docs-maintenance into .agents/skills/docs-maintenance/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-maintenance", 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/docker-tools --skill docs-maintenance -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dotnet/docker-tools docs-maintenance --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/docker-tools.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/docs-maintenance .cursor/skills/docs-maintenance && 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 "docs-maintenance" agent skill from https://github.com/dotnet/docker-tools/tree/main/.github/skills/docs-maintenance into .cursor/skills/docs-maintenance/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-maintenance", 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/docker-tools.git --path .github/skills/docs-maintenance--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/docker-tools --skill docs-maintenance -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dotnet/docker-tools docs-maintenance --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/docker-tools.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/docs-maintenance .gemini/skills/docs-maintenance && 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 "docs-maintenance" agent skill from https://github.com/dotnet/docker-tools/tree/main/.github/skills/docs-maintenance into .gemini/skills/docs-maintenance/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-maintenance", 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/docker-tools docs-maintenanceInstalls 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/docker-tools --skill docs-maintenance -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/dotnet/docker-tools.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/docs-maintenance .github/skills/docs-maintenance && 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 "docs-maintenance" agent skill from https://github.com/dotnet/docker-tools/tree/main/.github/skills/docs-maintenance into .github/skills/docs-maintenance/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-maintenance", 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/docker-tools --skill docs-maintenance -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/docker-tools docs-maintenance --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/docker-tools.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/docs-maintenance .opencode/skills/docs-maintenance && 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 "docs-maintenance" agent skill from https://github.com/dotnet/docker-tools/tree/main/.github/skills/docs-maintenance into .opencode/skills/docs-maintenance/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-maintenance", 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
docs-maintenance- GitHub stars
- 181
- Token cost
- ~1k tokens
- SKILL.md length
- 450 words
- Files
- 1
- Skills in repo
- 6
- Repo updated
- First seen
- Licence
- MIT
At a glance
Reviews or updates repository documentation as a dedicated task after implementation is complete.
- Works in 5 steps: Inspect the diff and identify changes to… → Decide whether contributors, consumers,… → Choose the narrowest document for the… → …
- Tasks that involve Pull requests
- SKILL.md covers Mode, Workflow, Documentation map and Output
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Docs Maintenance is an agent skill from dotnet/docker-tools, published by the product's own GitHub organization. Reviews or updates repository documentation as a dedicated task after implementation is complete. Use before submitting a pull request or when reviewing a pull request.
Its SKILL.md is about 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 Development, covering Pull requests. It works with .NET and GitHub. The repository describes itself as: This is a repo to house some common tools for our various docker repos. The licence is MIT.
When your agent uses it
- Tasks that involve Pull requests
Example prompts
- “Use the docs-maintenance skill to review or updates repository documentation as a dedicated task after implementation is complete”
- “/docs-maintenance”
Requirements
- Docker
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Inspect the diff and identify changes to behavior, contracts, workflows, generated outputs,
- Decide whether contributors, consumers, users, or agents need new information. Documentation
- Choose the narrowest document for the affected audience. Do not duplicate guidance unless
- In update mode, make the documentation changes. Prefer exact commands, paths, examples, and
- In review mode, report only actionable documentation gaps or unnecessary changes.
What it can do on your machine
Read from SKILL.md and the folder at commit fa471a5. 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
No scripts in the folder and no shell commands in SKILL.md.
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
Docs Maintenance loads about 1k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 450 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/docker-tools at commit fa471a5, republished under its MIT licence (© dotnet). 450 words, ~1,009 tokens.
Download SKILL.mdSave it as
.claude/skills/docs-maintenance/SKILL.md (or your agent's skills folder).- name
- docs-maintenance
- description
- Reviews or updates repository documentation as a dedicated task after implementation is complete. Use before submitting a pull request or when reviewing a pull request.
Documentation maintenance
Keep dotnet/docker-tools documentation accurate and scoped to the audience affected by a change.
Mode
- Update: edit the required documentation.
- Review: report missing, unnecessary, or misleading documentation changes without editing.
Infer the mode from the request. Requests to update, fix, add, or write documentation authorize updates; requests to check, review, or verify documentation use review mode.
Workflow
- Inspect the diff and identify changes to behavior, contracts, workflows, generated outputs, and agent expectations.
- Decide whether contributors, consumers, users, or agents need new information. Documentation is normally unnecessary for internal refactors, mechanical changes, test-only changes, or fixes whose intended behavior is already documented.
- Choose the narrowest document for the affected audience. Do not duplicate guidance unless distinct audiences need it.
- In update mode, make the documentation changes. Prefer exact commands, paths, examples, and migration steps. Preserve the existing structure unless it is misleading.
- In review mode, report only actionable documentation gaps or unnecessary changes.
Authentication documentation must distinguish Azure service connections, API authentication, git credentials, and pipeline variables when more than one appears in the change.
Do not edit files under eng/common/; they come from dotnet/arcade and will be overwritten.
Documentation map
| Document | Update when |
|---|---|
README.md | The repository purpose, tool list, or standard build and test entrypoints change. |
AGENTS.md | Repo-wide project structure, commands, source-of-truth rules, workflows, or agent invariants change. |
.github/instructions/*.md | High-level design guidance that shapes how an agent architects a change needs to be added, updated, or removed. Keep these files focused: they guide structural decisions and should not contain mechanical checklists. |
.github/agents/*.md, .github/skills/*/SKILL.md | An opt-in agent or reusable operational workflow changes. Review skills (such as reviewing-csharp) contain mechanical checklists of coding standards enforced during review; update them when a specific standard needs to be added, tightened, or removed. |
src/README.md | ImageBuilder invocation, command discovery, packaging, or local container-image builds change. |
documentation/manifest-file.md | Manifest concepts, schema generation, or authoring guidance change. |
documentation/signing.md | Signing configuration, credentials, certificates, trust stores, or pipeline flow change. |
documentation/base-image-dependency-flow.md | Base-image subscriptions, digest tracking, image-info usage, or rebuild triggers change. |
eng/docker-tools/DEV-GUIDE.md | Shared pipeline architecture, scripts, ImageBuilder integration, authentication, publishing, testing, or troubleshooting change. |
eng/docker-tools/CHANGELOG.md | A shared change affects downstream repositories, changes a contract or default, adds a capability, or requires migration. |
eng/tests/pipeline-validation/**/README*.md | A pipeline-validation fixture intentionally requires different README content. |
Show full SKILL.md (74 more words)Show less
For eng/docker-tools/CHANGELOG.md, include the date, issue or pull request when known, what
changed, and required downstream action. Do not add entries for internal changes with no
consumer impact.
Output
- Update: list each document changed and why; mention intentionally unchanged documents only when the choice is non-obvious.
- Review: report each gap as
changed area - required document - reason. Report unnecessary updates only when they would be stale, duplicated, or misleading. If none are needed, say so.
© 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 .github/skills/docs-maintenance of dotnet/docker-tools.
Open the folder on GitHubat commit fa471a5
Compare with similar skills
Docs Maintenance 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 |
|---|---|---|---|---|---|---|
| Docs Maintenance this skilldotnet/docker-tools | 181 | — | ~1k | Automated safety check: Pass | MIT | |
| MAUI PR Performance Analysisdotnet/maui | 23k | — | ~2.4k | Automated safety check: Pass | MIT | |
| Code Reviewjonathanpeppers/dotnes | 780 | — | ~2.1k | Automated safety check: Pass | MIT | |
| Gh Stackdotnet/macios | 2.9k | 2 repos | ~10k | Automated safety check: Pass | Custom licence | |
| Find Reviewable MAUI PRsdotnet/maui | 23k | — | ~1.7k | Automated safety check: Pass | MIT | |
| .NET MAUI Code Reviewdotnet/efcore | 15k | — | ~2k | Automated safety check: Pass | MIT |
Similar skills
- Official
Code Review
jonathanpeppers/dotnes
Review dotnes pull requests against established repository rules.
- Official
Gh Stack
dotnet/macios
Manage stacked branches and pull requests with the gh-stack GitHub CLI extension.
- Official
Find Reviewable MAUI PRs
dotnet/maui
Lists open pull requests in dotnet/maui and dotnet/docs-maui that are worth reviewing next, ranked by priority labels, milestone and partner or community origin.
- Official
.NET MAUI Code Review
dotnet/efcore
Deep code-only review of a pull request or candidate patch for correctness, safety and .NET MAUI conventions, judging the code before reading the PR description.
Code Review
OpenCoreMMO/OpenCoreMMO
Review pull requests and code changes for OpenCoreMMO against the project's architecture, conventions, and style defined in AGENTS.md.
More from dotnet/docker-tools
- Official
Investigating Pipeline
dotnet/docker-tools
Diagnoses a single Azure Pipelines build. An agent skill from dotnet/docker-tools.
- Official
Investigating Pull Request
dotnet/docker-tools
Inspect GitHub pull request status, read review comments, and diagnose PR validation failures.
- Official
Reviewing Csharp
dotnet/docker-tools
Reviews C changes in the ImageBuilder codebase against the repo's modern C conventions and invariants.
- Official
Triaging Pipelines
dotnet/docker-tools
Triage recent Azure Pipelines runs and failures. An agent skill from dotnet/docker-tools.
- Official
Triaging Pull Requests
dotnet/docker-tools
Triage open pull requests into actionable categories. An agent skill from dotnet/docker-tools.
Related
Categories
Questions about Docs Maintenance
What does Docs Maintenance do?
Reviews or updates repository documentation as a dedicated task after implementation is complete. Docs Maintenance is an agent skill from dotnet/docker-tools, published by the product's own GitHub organization. Reviews or updates repository documentation as a dedicated task after implementation is complete.
When should I use Docs Maintenance?
Docs Maintenance fits situations like: tasks that involve Pull requests.
How do I install Docs Maintenance in Claude Code?
Run `npx skills add dotnet/docker-tools --skill docs-maintenance -a claude-code`. Or copy the skill folder (.github/skills/docs-maintenance in dotnet/docker-tools) into .claude/skills/docs-maintenance in your project. Claude Code loads it when a task matches its description.
How do I install Docs Maintenance in Codex?
Run `npx skills add dotnet/docker-tools --skill docs-maintenance -a codex`. Or copy the skill folder (.github/skills/docs-maintenance in dotnet/docker-tools) into .agents/skills/docs-maintenance in your project. Codex loads it when a task matches its description.
Can I use Docs Maintenance 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/docker-tools --skill docs-maintenance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-maintenance, .gemini/skills/docs-maintenance, .github/skills/docs-maintenance and .opencode/skills/docs-maintenance in your project.
What does Docs Maintenance need to run?
SKILL.md names no scripts, command-line tools or credentials: Docs Maintenance is instructions for the agent only. Our summary lists: Docker.
Does Docs Maintenance 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 Docs Maintenance 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 Docs Maintenance use?
Docs Maintenance 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 Docs Maintenance use?
About 1k tokens (SKILL.md is roughly 4k 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 Docs Maintenance?
Skills that share tags, products or a category with Docs Maintenance: MAUI PR Performance Analysis (dotnet/maui, 23k stars), Code Review (jonathanpeppers/dotnes, 780 stars), Gh Stack (dotnet/macios, 2.9k stars) and Find Reviewable MAUI PRs (dotnet/maui, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Docs Maintenance?
dotnet (a GitHub organization, an official publisher) maintains it in dotnet/docker-tools, which has 181 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 2026.
Source: dotnet/docker-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.