.NET Skills — Instalar & Demo ao vivo

Name: .NET Skills (Claude Skill)
Author: Aaronontheweb

Por que usar

Principais recursos

Idiomas .NET 8/9 — primary constructors, collection expressions, required
Convenções de teste xUnit + FluentAssertions
Receitas BenchmarkDotNet — warmup adequado, modos GC, exporters
Sub-agente de correção async — sinaliza problemas de ConfigureAwait + cancelamento
Empacotamento NuGet — metadados do package, source-link, trimming flags
Multi-targeting + revisão de superfície de API

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dotnet-skills-aaronontheweb": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Aaronontheweb/dotnet-skills",
        "~/.claude/skills/dotnet"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "dotnet-skills-aaronontheweb": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Aaronontheweb/dotnet-skills",
        "~/.claude/skills/dotnet"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "dotnet-skills-aaronontheweb": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Aaronontheweb/dotnet-skills",
        "~/.claude/skills/dotnet"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dotnet-skills-aaronontheweb": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Aaronontheweb/dotnet-skills",
        "~/.claude/skills/dotnet"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "dotnet-skills-aaronontheweb",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Aaronontheweb/dotnet-skills",
        "~/.claude/skills/dotnet"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "dotnet-skills-aaronontheweb": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Aaronontheweb/dotnet-skills",
          "~/.claude/skills/dotnet"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add dotnet-skills-aaronontheweb -- git clone https://github.com/Aaronontheweb/dotnet-skills ~/.claude/skills/dotnet

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: .NET Skills

Audite um serviço para correção de async/await

👤 Times backend .NET ⏱ ~45 min advanced

Quando usar: Você herdou um serviço com deadlocks intermitentes e suspeita de problemas com async.

Pré-requisitos

Skill instalada — git clone https://github.com/Aaronontheweb/dotnet-skills ~/.claude/skills/dotnet

Fluxo

Escaneie

dotnet-skills async audit em src/. Sinalize: ConfigureAwait(false) faltando em bibliotecas, .Result/.Wait, async void (não-event), propagação de CancellationToken faltando.✓ Copiado

→ Lista concreta de file:line com severidade
Corrija um cluster

Escolha o cluster de maior severidade (risco de deadlock). Proponha patches, arquivo por arquivo. Mostre diffs.✓ Copiado

→ Patches cirúrgicos, não reescritas de arquivo inteiro

Resultado: Higiene async melhorada; uma fonte de deadlocks intermitentes eliminada.

Armadilhas

Correção ConfigureAwait quebra código de thread UI — A skill diferencia código de lib vs app; respeite essa fronteira

Combine com: filesystem

Faça benchmark de um hot path com BenchmarkDotNet

👤 Devs .NET curiosos sobre performance ⏱ ~60 min advanced

Quando usar: O profiler aponta para um método; você precisa de números rigorosos.

Fluxo

Crie o benchmark

Skill: crie um projeto BenchmarkDotNet para OrderCalc.Compute. Múltiplos tamanhos de input. Memory diagnoser habilitado. Markdown exporter.✓ Copiado

→ Projeto de benchmark compila; executa em Release
Execute + interprete

Execute o benchmark. Reporte mean, allocated, gen0. Qual é a principal alocação?✓ Copiado

→ Atribuição concreta ao alocador (provavelmente concatenação de string ou LINQ)
Patch + re-benchmark

Substitua LINQ por um loop manual. Execute novamente. Mostre antes/depois.✓ Copiado

→ Alocações caem de forma mensurável

Resultado: Melhoria de performance quantificada, não impressão subjetiva.

Armadilhas

Executando builds Debug — BenchmarkDotNet recusa Debug; garanta Release

Prepare uma biblioteca para release no NuGet

👤 Autores OSS ⏱ ~30 min intermediate

Quando usar: Primeiro release NuGet da sua lib; você quer que esteja polida.

Fluxo

Audite o empacotamento

dotnet-skills: audite MyLib.csproj para prontidão NuGet. Verifique Description, Authors, License, RepositoryUrl, source-link, multi-targeting.✓ Copiado

→ Lista concreta de campos faltando
Revisão de superfície de API

Gere a superfície de API pública; sinalize tipos internos vazados ou públicos com nomes estranhos.✓ Copiado

→ Dump de superfície de API com preocupações apontadas

Resultado: Pacote limpo pronto para publicar.

Armadilhas

Mismatch de licença (arquivo LICENSE vs <PackageLicenseExpression>) — A skill detecta isso; alinhe-os

Combinações

Combine com outros MCPs para 10× de alavancagem

dotnet-skills-aaronontheweb + filesystem

Aplique patches em todo o projeto

Aplique os patches do async_audit em src/. Um commit por arquivo.✓ Copiado

dotnet-skills-aaronontheweb + github

Abra PR com resultados de benchmark

Abra um PR com o patch de performance + benchmark antes/depois na descrição.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
async_audit	path	Verificação de saúde da codebase
scaffold_benchmark	target_method	Trabalho de performance
interpret_bench	bench_md	Após executar o benchmark
nuget_audit	csproj	Pré-release
api_surface	assembly_or_proj	Revisão de API
test_conventions_check	test_path	Revisão de PR

Custo e limites

O que custa rodar

Cota de API: N/A
Tokens por chamada: Auditorias escaneiam código = uso maior de tokens; 5k–30k por passagem
Monetário: Gratuito
Dica: Audite um projeto por vez; não espalhe por um monorepo de uma vez

Segurança

Permissões, segredos, alcance

Escopos mínimos: filesystem-read filesystem-write

Armazenamento de credenciais: Nenhum

Saída de dados: Nenhuma

A skill é opinativa para as convenções de Aaron — ajuste o prompt se o estilo da sua equipe for diferente

Solução de problemas

Erros comuns e correções

Audit too noisy

Especifique o threshold de severidade; a skill tem padrão para todos

Benchmark won't run

Deve ser build Release; BenchmarkDotNet recusa Debug

Verificar: dotnet build -c Release

API surface includes internal types

Certifique-se de que InternalsVisibleTo está configurado corretamente; a skill reporta como configurado

Alternativas

.NET Skills vs. outros

Alternativa	Quando usar	Troca
Roslyn analyzers in repo	Você quer imposição em tempo de CI	Mais configuração; menos interativo
ReSharper / Rider	Você quer correções em tempo de IDE	Pago; não controlado por LLM
Aspire / .NET Cloud Native skills	Foco em cloud-native	Escopo diferente

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills