Official agent skill

Msbuild Server

by microsoft in microsoft/testfx

Guide for using MSBuild Server to improve CLI build performance.

OfficialMITAuto-check passedBackend & APIs

Install Msbuild Server

skills CLI
$ npx skills add microsoft/testfx --skill msbuild-server -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/testfx msbuild-server --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/testfx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/msbuild-server .claude/skills/msbuild-server && rm -rf skills-src

Use ~/.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/

Facts

Skill name
msbuild-server
GitHub stars
1k
Token cost
~678 tokens
SKILL.md length
291 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
MIT

At a glance

Guide for using MSBuild Server to improve CLI build performance.

  • Works in 3 steps: Confirm CLI context → Set the environment variable → Validate improvement
  • Tasks that involve Secrets management
  • SKILL.md covers When to Use, When Not to Use, Inputs and Workflow, plus 2 more sections
  • Calls dotnet

What it does

Msbuild Server is an agent skill from microsoft/testfx, published by the product's own GitHub organization. Guide for using MSBuild Server to improve CLI build performance. Activate when developers report slow incremental builds from the command line, or when CLI builds are noticeably slower than IDE builds. Covers MSBUILDUSESERVER=1 environment variable for persistent server-based caching. Do not activate for IDE-based builds (Visual Studio already uses a long-lived process).

Its SKILL.md is about 680 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 Backend & APIs, covering Secrets management and Caching. It works with .NET. The repository describes itself as: This repository holds the source code of Microsoft.Testing.Platform (MTP), a lightweight alternative to VSTest, as well as MSTest adapter and framework. The licence is MIT.

When your agent uses it

  • Tasks that involve Secrets management
  • Tasks that involve Caching

Example prompts

  • “/msbuild-server”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Confirm CLI context
  2. Set the environment variable
  3. Validate improvement

What it can do on your machine

Read from SKILL.md and the folder at commit 44b9dcc. 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:

    • dotnet

    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

Msbuild Server loads about 678 tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 291 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~678

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 microsoft/testfx at commit 44b9dcc, republished under its MIT licence (© microsoft). 291 words, ~678 tokens.

Download SKILL.mdSave it as .claude/skills/msbuild-server/SKILL.md (or your agent's skills folder).
name
msbuild-server
description
Guide for using MSBuild Server to improve CLI build performance. Activate when developers report slow incremental builds from the command line, or when CLI builds are noticeably slower than IDE builds. Covers MSBUILDUSESERVER=1 environment variable for persistent server-based caching. Do not activate for IDE-based builds (Visual Studio already uses a long-lived process).
license
MIT

MSBuild Server for CLI Caching

Use the MSBuild Server to cache evaluation results across CLI builds, matching the performance advantage Visual Studio gets from its long-lived MSBuild process.

When to Use

  • Small incremental builds from CLI (dotnet build) are slower than expected
  • Developers notice that VS builds are faster than CLI builds for the same project
  • CI agents run many sequential builds of the same repo

When Not to Use

  • IDE-based builds (Visual Studio already uses a long-lived MSBuild process)
  • One-off builds where cold-start overhead is acceptable
  • Build correctness issues are suspected (disable the server to isolate the problem)

Inputs

InputRequiredDescription
Shell contextNoThe shell where the environment variable will be set (bash, PowerShell, or Windows persistent)

Workflow

Step 1: Confirm CLI context

Verify the developer is building from the command line (dotnet build), not from Visual Studio or another IDE. The MSBuild Server provides no benefit inside an IDE.

Step 2: Set the environment variable
bash
# Bash / CI
export MSBUILDUSESERVER=1

# PowerShell
$env:MSBUILDUSESERVER = "1"

# Windows (persistent)
setx MSBUILDUSESERVER 1
Step 3: Validate improvement

Run two sequential builds of the same project and compare times:

  1. First build (cold): dotnet build -- server starts, no cache benefit
  2. Second build (warm): dotnet build -- should be noticeably faster

The most noticeable improvement is in repos with many projects or complex Directory.Build.props chains.

Validation

  • MSBUILDUSESERVER=1 is set in the shell
  • Second sequential build is faster than the first
  • dotnet build-server shutdown followed by a rebuild confirms the server restarts cleanly

Common Pitfalls

PitfallSolution
Expecting improvement in Visual StudioVS already uses long-lived MSBuild nodes; the server adds no benefit
Build correctness issues after enablingRun dotnet build-server shutdown to reset; if issues persist, disable the server
Server process using unexpected memoryThe server persists in background; shut down with dotnet build-server shutdown when idle

© microsoft, 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/msbuild-server of microsoft/testfx.

Open the folder on GitHubat commit 44b9dcc

Compare with similar skills

Msbuild Server 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.

Msbuild Server compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Msbuild Server this skillmicrosoft/testfx1k—~678Automated safety check: PassMIT
Project Setupcodewithmukesh/dotnet-claude-kit751—~1.2kAutomated safety check: PassMIT
Rds Sqlserveraws/agent-toolkit-for-aws2.8k—~6.3kAutomated safety check: PassApache-2.0
FoundatioFoundatioFx/Foundatio2.1k—~3.9kAutomated safety check: PassApache-2.0
Cachingcodewithmukesh/dotnet-claude-kit7511 repos~1.4kAutomated safety check: PassMIT
Dotnet Backend Patternswshobson/agents40k7 repos~6.6kAutomated safety check: PassMIT

Similar skills

  • Project Setup

    codewithmukesh/dotnet-claude-kit

    Tech-stack selection advisor for .NET projects: recommended defaults for database, auth, caching, messaging, observability, and resilience, with the rationale behind each default.

    751 GitHub stars~1.2k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Rds Sqlserver

    aws/agent-toolkit-for-aws

    Official

    Provides connectivity, authentication, and troubleshooting guidance for Amazon RDS for SQL Server.

    2.8k GitHub stars~6.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Foundatio

    FoundatioFx/Foundatio

    A skill your agent uses when working with Foundatio infrastructure abstractions for .NET -- caching, queuing, messaging, file storage, distributed locking, or background jobs.

    2.1k GitHub stars~3.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Caching

    codewithmukesh/dotnet-claude-kit

    Caching strategies for .NET 10 applications. An agent skill from codewithmukesh/dotnet-claude-kit.

    751 GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check passed
  • Master C/.NET backend development patterns for building robust APIs, MCP servers, and enterprise applications.

    40k GitHub starsUsed in 7 repos~6.6k tokens
    Backend & APIsAuto-check passed
  • Build Perf Baseline

    dotnet/skills

    Official

    Establish MSBuild/.NET build performance baselines before optimizing.

    5.6k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed

More from microsoft/testfx

All 44 skills in this repo
  • Official

    Guide for organizing MSBuild infrastructure with Directory.Build.props, Directory.Build.targets, Directory.Packages.props, and Directory.Build.rsp.

    1k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Binlog Failure Analysis

    microsoft/testfx

    Official

    Analyze MSBuild binary logs to diagnose build failures. An agent skill from microsoft/testfx.

    1k GitHub starsUsed in 3 repos~730 tokens
    Auto-check passed
  • Coverage Analysis

    microsoft/testfx

    Official

    Project-wide code coverage and CRAP (Change Risk Anti-Patterns) score analysis for .NET projects.

    1k GitHub stars~7.3k tokensUpdated today
    Auto-check passed
  • Incremental Build

    microsoft/testfx

    Official

    Guide for optimizing MSBuild incremental builds. An agent skill from microsoft/testfx.

    1k GitHub starsUsed in 3 repos~3.7k tokens
    Auto-check passed
  • Msbuild Modernization

    microsoft/testfx

    Official

    Guide for modernizing and migrating MSBuild project files to SDK-style format.

    1k GitHub starsUsed in 3 repos~4.3k tokens
    Auto-check passed
  • Msbuild Antipatterns

    microsoft/testfx

    Official

    Catalog of MSBuild anti-patterns with detection rules and fix recipes.

    1k GitHub stars~4.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Msbuild Server

What does Msbuild Server do?

Guide for using MSBuild Server to improve CLI build performance. Msbuild Server is an agent skill from microsoft/testfx, published by the product's own GitHub organization. Guide for using MSBuild Server to improve CLI build performance.

When should I use Msbuild Server?

Msbuild Server fits situations like: tasks that involve Secrets management; tasks that involve Caching.

How do I install Msbuild Server in Claude Code?

Run `npx skills add microsoft/testfx --skill msbuild-server -a claude-code`. Or copy the skill folder (.agents/skills/msbuild-server in microsoft/testfx) into .claude/skills/msbuild-server in your project. Claude Code loads it when a task matches its description.

How do I install Msbuild Server in Codex?

Run `npx skills add microsoft/testfx --skill msbuild-server -a codex`. Or copy the skill folder (.agents/skills/msbuild-server in microsoft/testfx) into .agents/skills/msbuild-server in your project. Codex loads it when a task matches its description.

Can I use Msbuild Server 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 microsoft/testfx --skill msbuild-server -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/msbuild-server, .gemini/skills/msbuild-server, .github/skills/msbuild-server and .opencode/skills/msbuild-server in your project.

What does Msbuild Server need to run?

Going by SKILL.md and its folder, Msbuild Server needs the command-line tools its instructions call (dotnet).

Does Msbuild Server 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 Msbuild Server 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 Msbuild Server use?

Msbuild Server is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Msbuild Server use?

About 678 tokens (SKILL.md is roughly 2.7k 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 Msbuild Server?

Skills that share tags, products or a category with Msbuild Server: Project Setup (codewithmukesh/dotnet-claude-kit, 751 stars), Rds Sqlserver (aws/agent-toolkit-for-aws, 2.8k stars), Foundatio (FoundatioFx/Foundatio, 2.1k stars) and Caching (codewithmukesh/dotnet-claude-kit, 751 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Msbuild Server?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/testfx, which has 1,047 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 7, 2026.

Source: microsoft/testfx on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.