Multi-dimensional health assessment for .NET projects with letter grades (A-F) using Roslyn MCP tools.

MITAuto-check passedDevelopment

Install Health Check

skills CLI
$ npx skills add codewithmukesh/dotnet-claude-kit --skill health-check -a claude-code

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

GitHub CLI
$ gh skill install codewithmukesh/dotnet-claude-kit health-check --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/codewithmukesh/dotnet-claude-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/health-check .claude/skills/health-check && 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
health-check
GitHub stars
755
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
645 words
Files
2 (incl. references)
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Multi-dimensional health assessment for .NET projects with letter grades (A-F) using Roslyn MCP tools.

  • Works in 5 steps: Choose Scope → Run the Dimensions → 5: Triage Gate (before any grade is… → …
  • Tasks that involve Code quality
  • SKILL.md covers What, When, How and Example, plus 1 more section
  • Calls dotnet

What it does

Health Check is an agent skill from codewithmukesh/dotnet-claude-kit. Multi-dimensional health assessment for .NET projects with letter grades (A-F) using Roslyn MCP tools. Evaluates 8 dimensions: build health, code quality, architecture, test coverage, dead code, API surface, security posture, and documentation. Produces a structured report card with actionable recommendations. Load this skill when: "health check", "how healthy is this", "project health", "code quality report", "grade this project", "assess codebase", "quality audit", "technical assessment", "codebase review"…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/grading-rubric.md`).

It sits in Development, covering Code quality, Test coverage and MCP servers. It works with .NET. The repository describes itself as: Make Claude Code a .NET 10 Expert. The licence is MIT.

When your agent uses it

  • Tasks that involve Code quality
  • Tasks that involve Test coverage
  • Tasks that involve MCP servers

Example prompts

  • “health check”
  • “how healthy is this”
  • “project health”
  • “/health-check”

Workflow steps

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

  1. Choose Scope
  2. Run the Dimensions
  3. 5: Triage Gate (before any grade is assigned)
  4. Grade and Aggregate
  5. Report

What it can do on your machine

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

Health Check loads about 1.6k tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 136 tokens; SKILL.md has 645 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~136
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.1k

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 codewithmukesh/dotnet-claude-kit at commit 2330089, republished under its MIT licence (© codewithmukesh). 645 words, ~1,593 tokens.

Download SKILL.mdSave it as .claude/skills/health-check/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
health-check
description
Multi-dimensional health assessment for .NET projects with letter grades (A-F) using Roslyn MCP tools. Evaluates 8 dimensions: build health, code quality, architecture, test coverage, dead code, API surface, security posture, and documentation. Produces a structured report card with actionable recommendations. Load this skill when: "health check", "how healthy is this", "project health", "code quality report", "grade this project", "assess codebase", "quality audit", "technical assessment", "codebase review", "report card".

/health-check — 8-Dimension Project Assessment

What

Runs a data-driven health assessment across 8 dimensions, each graded A-F with the specific data points that produced the grade, and rolls them into a GPA. Gut feeling is not a grade: every dimension uses MCP tools or CLI commands, and every grade below A comes with specific, prioritized, effort-estimated fixes — "add test classes for OrderService, PaymentProcessor, ShippingCalculator" is actionable; "improve test coverage" is not.

This skill owns the canonical grading system for the kit. The full rubrics, GPA scale, and report template live in references/grading-rubric.md — load that file when running an assessment.

Tone is diagnostic, not punitive: a C grade is an improvement path, not a failure.

When

  • Onboarding to an unfamiliar or new project — set the baseline
  • "How healthy is this?", "grade this project", "codebase review", "report card"
  • Pre-release quality gate, or monthly/quarterly maintenance review
  • After a cleanup sprint (/de-sloppify) — re-grade to show progress
  • Tech-debt prioritization — lowest grades get the next sprint's attention

How

Step 1: Choose Scope
ScenarioDimensions
Full assessment (onboarding, pre-release, monthly review)All 8
Quick health (mid-sprint checkpoint, before a demo, after a merge)1-4 only
After major refactor1 (Build), 3 (Architecture), 4 (Tests)
Post-dependency update1 (Build), 7 (Security)
After cleanup sprintRe-grade only the cleaned dimensions
Step 2: Run the Dimensions

Read references/grading-rubric.md for the grade thresholds, then collect data per dimension. For deep code-quality dimensions, delegate to the code-reviewer agent with the code-review skill.

#DimensionData source
1Build Healthdotnet build --no-restore — errors + warnings
2Code QualityMCP detect_antipatterns — read summary, grade high-confidence only
3ArchitectureMCP get_project_graph + detect_circular_dependencies (projects AND types)
4Test CoverageMCP get_test_coverage_map — check applicable first (structural, not line coverage)
5Dead CodeMCP find_dead_code(scope: "solution") — grade high-confidence; ignore conventionFiltered
6API SurfaceMCP get_public_api + find_references — overexposure, return-type consistency
7Security Posturedotnet list package --vulnerable --include-transitive + secrets/auth spot check (deep dive: /security-scan)
8DocumentationXML doc coverage on public APIs + README currency
Show full SKILL.md (322 more words)Show less
Step 2.5: Triage Gate (before any grade is assigned)

Detector output is evidence, not a grade. Pass every finding through this gate first — it is what stops a noisy count becoming a wrong letter.

  1. Read summary, not the violation list. summary.byId is complete even when the list is truncated. Never sample a truncated list and extrapolate.
  2. Drop suppressed. Record the count and summary.suppressionConfig in the report so suppression stays visible.
  3. Set aside medium. These are review items, not grade inputs. Summarise them by category; do not fix or count them.
  4. Grade high only. These are wrong regardless of context.
  5. Check invariants. If a signal contradicts something the target repo's CLAUDE.md documents as deliberate, the invariant wins — verify before grading.
  6. Read before asserting. Never describe a finding you have not opened. If you cannot open all of them, report the ones you did and say so.

Fill in the triage table from references/grading-rubric.md as you go. If the table cannot be filled, the dimension is not ready to grade.

Step 3: Grade and Aggregate

Apply the rubric thresholds exactly — never grade on a curve ("pretty good for a project this size" is how standards erode; 15 warnings is a C regardless of project size). Convert to GPA (A=4.0 … F=0.0), averaging only the dimensions actually graded — a dimension marked "Not assessed" is excluded from the GPA, never scored as an F.

Step 4: Report

Produce the report card from the template in references/grading-rubric.md: grades table with key findings, overall GPA, and priority recommendations — each with named types/files, priority order, and effort estimates. If a previous report exists, append the trend comparison table.

Example

User: /health-check

Claude: Running full 8-dimension assessment...

| Dimension | Grade | Key Finding |
|-----------|-------|-------------|
| Build Health | A | 0 errors, 2 warnings |
| Code Quality | B | 3 high-confidence findings in 4.2K lines; 31 medium untriaged |
| Architecture | A | Clean direction, 0 cycles |
| Test Coverage | Not assessed | Integration-driven suite — structural metric invalid |
| Dead Code | B | 5 unused methods (79 convention-discovered, not counted) |
| API Surface | B | 2 overexposed service types |
| Security | A | 0 vulnerable packages |
| Documentation | D | 12/30 public APIs documented |

Overall GPA: 3.1 (B) — averaged over 7 graded dimensions.

Triage: 44 AP005 raw → all log-and-rethrow wrappers (medium); 2 AP004 real.

Priority: (1) `SystemSeeder` → `TimeProvider`, ~15 min; (2) XML docs on the 8
endpoint classes, ~1 day; (3) review the 44 catch blocks or suppress by path.
  • references/grading-rubric.md — canonical rubrics, GPA scale, report template
  • /de-sloppify — cleanup pipeline for the issues a health check surfaces
  • /security-scan — deep 6-layer scan behind Dimension 7
  • /code-review — per-change review (this skill grades the whole project)
  • /verify — pass/fail pipeline for a change set, not a graded assessment

© codewithmukesh, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/health-check of codewithmukesh/dotnet-claude-kit.

  • SKILL.md
  • references/grading-rubric.md

Open the folder on GitHubat commit 2330089

Used in 1 other repository

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in codewithmukesh/dotnet-claude-kit, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Health Check 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.

Health Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Health Check this skillcodewithmukesh/dotnet-claude-kit7551 repos~1.6kAutomated safety check: PassMIT
Coverage Analysis for .NETdotnet/skills5.6k1 repos~2.8kAutomated safety check: PassMIT
Mcaf Dotnet Quality CImanagedcode/Storage138—~1.7kAutomated safety check: PassMIT
Quality CImanagedcode/dotnet-skills486—~2.1kAutomated safety check: PassMIT
Constraint-Driven Developmentaddyosmani/agent-skills103k2 repos~5.2kAutomated safety check: PassMIT
Score Harnessruvnet/metaharness694—~613Automated safety check: PassMIT

Similar skills

  • Official

    Interprets .NET coverage reports to explain line and branch gaps, target arithmetic and, on request, CRAP-based risk hotspots, without rerunning tests.

    5.6k GitHub starsUsed in 1 repo~2.8k tokens
    Testing & QAAuto-check passed
  • Mcaf Dotnet Quality CI

    managedcode/Storage

    Set up or refine open-source .NET code-quality gates for CI: formatting, .editorconfig, SDK analyzers, third-party analyzers, coverage, mutation testing, architecture tests, and security scanning.

    138 GitHub stars~1.7k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Quality CI

    managedcode/dotnet-skills

    Set up or refine open-source .NET code-quality gates for CI: formatting, .editorconfig, SDK analyzers, third-party analyzers, coverage, mutation testing, architecture tests, and security scanning.

    486 GitHub stars~2.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Constraint-Driven Development

    addyosmani/agent-skills

    Records a project's quality bar in CONSTRAINTS.md and watches diffs for signs an agent quietly weakened it, such as suppressions, skipped tests or lowered thresholds.

    103k GitHub starsUsed in 2 repos~5.2k tokens
    DevelopmentAuto-check passed
  • Score Harness

    ruvnet/metaharness

    5-dimension scorecard (0-100, grade A/B/C/F) for a scaffolded harness.

    694 GitHub stars~613 tokensUpdated today
    DevelopmentAuto-check passed
  • Lsp Inspect

    blackwell-systems/agent-lsp

    Full code quality audit for a file, package, or directory. An agent skill from blackwell-systems/agent-lsp.

    160 GitHub stars~4.2k tokensUpdated today
    DevelopmentAuto-check: notes

More from codewithmukesh/dotnet-claude-kit

All 47 skills in this repo
  • API Versioning

    codewithmukesh/dotnet-claude-kit

    API versioning strategies for ASP.NET Core. An agent skill from codewithmukesh/dotnet-claude-kit.

    755 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Scaffold

    codewithmukesh/dotnet-claude-kit

    Architecture-aware feature scaffolding for .NET 10 projects.

    755 GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed
  • Architecture Advisor

    codewithmukesh/dotnet-claude-kit

    Architecture selection advisor for .NET applications. An agent skill from codewithmukesh/dotnet-claude-kit.

    755 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed
  • Aspire

    codewithmukesh/dotnet-claude-kit

    .NET Aspire for cloud-native orchestration. An agent skill from codewithmukesh/dotnet-claude-kit.

    755 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Authentication

    codewithmukesh/dotnet-claude-kit

    Authentication and authorization for ASP.NET Core. An agent skill from codewithmukesh/dotnet-claude-kit.

    755 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Caching

    codewithmukesh/dotnet-claude-kit

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

    755 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

Works with

Questions about Health Check

What does Health Check do?

Multi-dimensional health assessment for .NET projects with letter grades (A-F) using Roslyn MCP tools. Health Check is an agent skill from codewithmukesh/dotnet-claude-kit.NET projects with letter grades (A-F) using Roslyn MCP tools.

When should I use Health Check?

Health Check fits situations like: tasks that involve Code quality; tasks that involve Test coverage; tasks that involve MCP servers.

How do I install Health Check in Claude Code?

Run `npx skills add codewithmukesh/dotnet-claude-kit --skill health-check -a claude-code`. Or copy the skill folder (skills/health-check in codewithmukesh/dotnet-claude-kit) into .claude/skills/health-check in your project. Claude Code loads it when a task matches its description.

How do I install Health Check in Codex?

Run `npx skills add codewithmukesh/dotnet-claude-kit --skill health-check -a codex`. Or copy the skill folder (skills/health-check in codewithmukesh/dotnet-claude-kit) into .agents/skills/health-check in your project. Codex loads it when a task matches its description.

Can I use Health Check 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 codewithmukesh/dotnet-claude-kit --skill health-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/health-check, .gemini/skills/health-check, .github/skills/health-check and .opencode/skills/health-check in your project.

What does Health Check need to run?

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

Does Health Check 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 Health Check 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 Health Check use?

Health Check 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 Health Check use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.5k tokens, read only when the agent opens those files.

What are the alternatives to Health Check?

Skills that share tags, products or a category with Health Check: Coverage Analysis for .NET (dotnet/skills, 5.6k stars), Mcaf Dotnet Quality CI (managedcode/Storage, 138 stars), Quality CI (managedcode/dotnet-skills, 486 stars) and Constraint-Driven Development (addyosmani/agent-skills, 103k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Health Check?

codewithmukesh (a GitHub organization) maintains it in codewithmukesh/dotnet-claude-kit, which has 755 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on August 7, 2026.

Source: codewithmukesh/dotnet-claude-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.