🎯 Why dotnet-agent-skills?

| Traditional Approach | With dotnet-agent-skills | |---------------------|-------------------------| | ❌ AI suggests inconsistent code fixes | ✅ Review-first: AI proposes, you decide | | ❌ Black-box recommendations | ✅ Auditable outputs with evidence | | ❌ Generic patterns | ✅ .NET-specific best practices | | ❌ Manual chaining of review tasks | ✅ Smart agent chaining with conditions |

29 production-ready skills covering security, performance, architecture, testing, desktop, and more — designed specifically for .NET/ASP.NET Core.

🎯 Overview

dotnet-agent-skills provides Agent Skills for Claude Code and AI coding assistants, optimized for .NET/ASP.NET Core with:

• Review-first approach: AI proposes findings, you approve changes
• Deterministic workflows: Reproducible bash scripts, no magic
• Auditable outputs: Severity, confidence, evidence, recommendations
• Smart chaining: Context-aware related-skill activation
• Safe installation: Backup & checksum verification

🚀 Quick Start

Install

npm install -g dotnet-agent-skills     # Global
npx agentnet init                      # Or run quickly with npx

Initialize in your project

cd your-dotnet-project
agentnet init                      # interactive
agentnet init --yes                # non-interactive (defaults)
agentnet init --force             # overwrite existing .claude/

Verify

agentnet doctor    # diagnostics
agentnet validate  # validate .claude/ structure
agentnet skill list

⚡ Slash Commands (Provided by dotnet-agent-skills)

After running agentnet init, the following slash commands are available in your project:

| Command | Description | Example | |---------|-------------|---------| | /build [path] | Build, test & pack .NET solution with validation | /build src/MySolution.sln | | /dev-review [path] | Comprehensive code review for .NET projects | /dev-review src/ | | /test-net [path] | Run tests and analyze coverage for .NET | /test-net tests/ | | /brainstorm-net [question] | Brainstorm .NET architecture & solutions with trade-off analysis | /brainstorm-net "EF Core vs Dapper for read-heavy queries" | | /pm-assess [path] | Review PM/Delivery artifacts with evidence-based reporting | /pm-assess ./docs --scope delivery --focus risks | | /winform [screenshot] | Design WinForms UI from screenshot (modern convention) | /winform ./design.png | | /winform-old [screenshot] | Design WinForms UI from screenshot (legacy convention) | /winform-old ./design.png | | /security [path] | Security review for .NET applications | /security src/ | | /orchestrate [path] | Orchestrate multiple review skills | /orchestrate src/ |

Note: These commands are automatically installed to .claude/commands/ when you run agentnet init

💻 Usage

CLI Commands

agentnet init                                    # setup
agentnet skill list                              # list skills
agentnet skill info reviewing-clean-code-dotnet  # skill details
agentnet doctor                                  # diagnostics
agentnet validate                                # structure check
agentnet update                                  # update skills
agentnet config list                             # show config

📦 Skills Catalog

| Domain | Count | Skills | |--------|-------|--------| | Tooling | 4 | build/test workflow, CI/CD pipelines, NuGet selection, review orchestration | | API | 3 | API design, OpenAPI/Swagger docs, bilingual VI/EN messages | | Security | 4 | auth hardening, HTTP resilience, vulnerability scans, secrets detection | | Data | 2 | EF Core reviews, Dapper + SQL Server optimization (incl. LINQ to SQL) | | Performance | 2 | caching strategies, sync-over-async detection | | Style | 3 | code formatting, clean code reviews, XML scaffolding | | Architecture | 2 | architecture evaluation, DI lifetime reviews | | Desktop | 2 | WinForms general review, DevExpress conventions | | Test | 1 | integration testing with Testcontainers | | Ops | 1 | error handling with Problem Details | | Observability | 1 | logging, tracing, metrics with OpenTelemetry | | PM | 1 | requirements analysis and estimation | | Meta | 3 | brainstorming, project conventions, templates |

Full details: SKILLS.md

🔄 What's New

v1.7.1 (Latest)

• ✨ New Skills:

  • reviewing-winforms-applications - General WinForms application review (Designer safety, form lifecycle, data binding, UI threading, MVP architecture)
  • LINQ to SQL support in dapper-sqlserver skill

• ✨ New Slash Commands:

  • /winform - WinForms UI design from screenshot (modern convention)
  • /winform-old - WinForms UI design from screenshot (legacy convention)

• 🔧 Improvements:

  • Renamed workflows to avoid conflicts with Claude built-ins: /brainstorm → /brainstorm-net, /review → /dev-review, /test → /test-net, /review-pm → /pm-assess
  • Reorganized desktop skills structure
  • Added comprehensive WinForms code examples and templates

• 📦 Package:

  • Version: 1.7.1
  • Size: 464 KB
  • Skills: 24 across 13 domains

v1.6.0

• ✨ New Slash Commands:

  • /review-pm - PM/Delivery assessment with evidence-based reporting
  • /brainstorm - .NET architecture & solution brainstorming

• 🔧 Improvements:

  • Converted workflow docs to executable slash command format
  • Fixed ESLint issues in scaffolding module
  • Updated build pipeline for better validation

• 📦 Package:

  • Size: 197KB
  • Tests: 26/26 passing
  • Skills: 22 across 10 domains

🛠️ Requirements

• Node.js >= 18.0.0
• .NET SDK >= 8.0 (for builds/tests)
• Git
• Bash (for skill scripts), ripgrep (optional)

🤝 Contributing & Feedback

• Issues/requests: GitHub Issues
• Email: [email protected]
• Repo includes skill structure, validation scripts, and authoring guidance

📄 License

MIT © thanhquangqb95