afonsoft

Use when creating, updating, or standardizing GitHub Actions workflows for a .NET repository, especially C# libraries, NuGet packages, ABP/EAF web apps, or Angular frontends.

Bootstrap a complete production-ready agent harness in a repository — CLAUDE.md, .claude/, .devin/, skills/, rules/, ignore files, and sub-agents. Use when initializing AI agent support in a new repo, restructuring existing agent files into modern File-based Context conventions, or generating harness artifacts following Agent = Model + Harness principles. Targets Claude Code and Devin CLI only — does NOT create artifacts for OpenCode, Cursor, Gemini, Copilot or JetBrains AI. Do NOT use for building MCP servers (use building-mcp-servers).

Install and configure RTK (Rust Token Killer) — a high-performance CLI proxy that reduces LLM token consumption by 60-90%. Automatically rewrites shell commands to their rtk equivalents via hooks. Use when setting up a new dev environment or when token optimization is needed. Do NOT use when raw unfiltered output is required (use rtk proxy for that).

Apply Test-Driven Development to skill authoring — write pressure scenarios with subagents (test cases), observe baseline failures (RED), write the skill (GREEN), close loopholes through refactor cycles. Use when creating new skills, editing existing skills, or verifying skills work before deployment. Do NOT use for one-off solutions, project-specific conventions (put in AGENTS.md/CLAUDE.md), or mechanical constraints enforceable via regex/validation. Companion skills: brainstorming (for design phase), create-agent-harness (for bootstrapping agent harness in a repo).

Use when working with ABP module system, dependency injection, base classes, time handling, business exceptions, or localization patterns

Use when designing and implementing RESTful APIs with ASP.NET Core, or when applying security, error handling, documentation, testing, or performance optimization to API endpoints

Use when building Blazor applications with Microsoft Fluent UI components, setting up the library, or troubleshooting FluentUI component issues

Use when creating, updating, or managing GitHub issues — bug reports, feature requests, labels, assignments, dependencies, or workflows

Implement dependency injection in Angular v20+ using inject(), injection tokens, and provider configuration. Use for service architecture, providing dependencies at different levels, creating injectable tokens, and managing singleton vs scoped services. Triggers on service creation, configuring providers, using injection tokens, or understanding DI hierarchy.

Create custom directives in Angular v20+ for DOM manipulation and behavior extension. Use for attribute directives that modify element behavior/appearance, structural directives for portals/overlays, and host directives for composition. Triggers on creating reusable DOM behaviors, extending element functionality, or composing behaviors across components. Note - use native @if/@for/@switch for control flow, not custom structural directives.

Build signal-based forms in Angular v21+ using the new Signal Forms API. Use for form creation with automatic two-way binding, schema-based validation, field state management, and dynamic forms. Triggers on form implementation, adding validation, creating multi-step forms, or building forms with conditional fields. Signal Forms are experimental but recommended for new Angular projects.

Implement server-side rendering and hydration in Angular v20+ using @angular/ssr. Use for SSR setup, hydration strategies, prerendering static pages, and handling browser-only APIs. Triggers on SSR configuration, fixing hydration mismatches, prerendering routes, or making code SSR-compatible.

Write unit and integration tests for Angular v21+ applications using Vitest or Jasmine with TestBed, component harnesses, and modern testing patterns. Use for testing components with signals, OnPush change detection, services with inject(), and HTTP interactions. Triggers on test creation, testing signal-based components, mocking dependencies, or setting up test infrastructure.

Use Angular CLI and development tools effectively in Angular v20+ projects. Use for project setup, code generation, building, testing, and configuration. Triggers on creating new projects, generating components/services/modules, configuring builds, running tests, or optimizing production builds.

Choosing the right concurrency abstraction in .NET - from async/await for I/O to Channels for producer/consumer to Akka.NET for stateful entity management. Avoid locks and manual synchronization unless absolutely necessary.

Use when building C# applications with .NET 8+, ASP.NET Core APIs, or Blazor web apps. Invoke for Entity Framework Core, minimal APIs, async patterns, CQRS with MediatR.

Complete ASP.NET Core REST API development with best practices, security, testing, and deployment patterns

Complete Blazor component development with modern patterns, state management, and best practices

Create a new ABP.IO project using CLI commands with proper template selection, configuration, and setup. Supports all ABP templates including layered, single-layer, microservice, and modular architectures.

Create a new ABP.IO project with proper template selection, configuration, and setup. Supports all ABP templates including layered, single-layer, microservice, and modular architectures.

Create a new ASP.NET Boilerplate project with proper template selection, configuration, and setup. Supports all ASP.NET Boilerplate templates including MVC, Angular, and module-zero templates.

Master asynchronous programming in C# with proper async/await patterns, error handling, and performance optimization

Comprehensive guide to software design patterns, SOLID principles, and architectural patterns for .NET applications

Ensures .NET/C# code follows modern best practices, SOLID principles, and industry standards for production-ready applications

Master C#/.NET backend development patterns for building robust APIs, MCP servers, and enterprise applications. Covers async/await, dependency injection, Entity Framework Core, Dapper, configuration, caching, and testing with xUnit. Use when developing .NET backends, reviewing C# code, or designing API architectures.

Expert guidance for TypeScript and Angular development for the EAF (Enterprise Application Foundation) project. Covers Angular 18, standalone components, signals, reactive forms, PrimeNG integration, jQuery legacy integration, SignalR real-time features, accessibility (WCAG AA), and EAF-specific framework integration. Use this skill when developing Angular components, integrating with EAF backend, or troubleshooting frontend issues. Do NOT use for backend API development, non-Angular frontend frameworks, or general TypeScript projects.

Expert guidance for ASP.NET Boilerplate (ABP) and .NET 10.0 development for the EAF (Enterprise Application Foundation) middleware modules. Covers N-Layer Architecture, dependency injection with Castle Windsor, multi-tenancy, authorization, caching, background jobs, Entity Framework Core, EAF-specific middleware modules (Serilog, KeyVault, OpenTelemetry, SQL Server/SQLite cache), and ABP best practices. Use this skill when developing EAF middleware modules, working with ABP framework, implementing repositories/application services, or troubleshooting ABP-related issues. Do NOT use for general .NET development, non-ABP projects, or frontend development.

Expert guidance for working with ASP.NET Boilerplate (ABP) framework modules. Covers module definition, lifecycle methods, dependencies, configuration, and usage of common ABP modules including dependency injection, session, caching, logging, settings, entities, repositories, application services, authorization, multi-tenancy, and more. Use this skill when creating ABP modules, configuring module dependencies, understanding ABP module system, or troubleshooting module initialization issues. Do NOT use for general .NET development, non-ABP projects, or EAF-specific middleware modules.

Ensure .NET/C# code meets best practices for the EAF solution. Covers documentation, architecture, DI with Castle Windsor, async patterns, testing with xUnit/Shouldly/NSubstitute, configuration, error handling, and SOLID principles. Use when reviewing code quality, implementing new features, or ensuring standards compliance.

Expert guidance for developing, maintaining, and extending EAF (Enterprise Application Foundation) RESTful APIs using ASP.NET Core, ABP framework, and EAF middleware modules. Covers dynamic API generation, DTO patterns, authentication, authorization, caching, Swagger/OpenAPI documentation, and EAF-specific API patterns like KeyVault, OpenTelemetry, and cache integration. Use this skill when creating REST APIs, working with Application Services, implementing authentication/authorization, configuring Swagger, or troubleshooting API endpoints. Do NOT use for frontend development, database migrations, or non-API backend work.

Expert guidance for CI/CD pipelines in EAF (Enterprise Application Foundation) using GitHub Actions, shell scripts, and Docker. Covers build automation, test execution, code coverage, NuGet packaging, deployment to Azure, and EAF-specific CI/CD patterns. Use this skill when configuring GitHub Actions workflows, setting up build scripts, implementing automated testing, or troubleshooting CI/CD failures. Do NOT use for general DevOps tasks, non-EAF projects, or infrastructure as code outside CI/CD context.

Guidance for analyzing and improving code quality in EAF projects. Covers build warning analysis, test coverage improvement, code analysis rules, and systematic approaches to technical debt reduction. Use when fixing compiler warnings, increasing test coverage, running code analysis, or performing code quality audits. Do NOT use for new feature development, architectural changes, or frontend development.

What: Guia para desenvolvimento de renderizadores, payloads e funcionalidades do QRCoder.Core. When: Ao criar novos renderizadores, adicionar payloads, modificar o QRCodeGenerator, ou trabalhar com SkiaSharp. Do NOT: Não usar para testes (ver qrcode-testing), CI/CD, ou documentação isolada.

What: Guia para testes unitários do QRCoder.Core usando xUnit, Shouldly e coverlet. When: Ao escrever testes, aumentar cobertura, debugar falhas de teste, ou configurar test runners. Do NOT: Não usar para desenvolvimento de features (ver qrcode-development) ou CI/CD.

What: Guia para desenvolvimento de ChunkDecoders, entidades e funcionalidades dos decodificadores METAR e TAF. When: Ao criar novos decoders, modificar entidades, trabalhar com regex de parsing, ou adicionar suporte a novos formatos. Do NOT: Não usar para testes (ver metar-testing), CI/CD, ou documentação isolada.

What: Guia para testes dos decodificadores METAR e TAF usando NUnit e coverlet. When: Ao escrever testes, aumentar cobertura, debugar falhas, ou validar decoders com dados reais. Do NOT: Não usar para desenvolvimento de features (ver metar-development) ou CI/CD.

What: desenvolver features no EAF Template BFF seguindo Clean Architecture e .NET 10. When: ao criar/modificar controllers, services, clients, configuração ou middleware. Do NOT: não use para CI/CD, documentação isolada ou testes (use bff-testing).

What: escrever e executar testes para o EAF Template BFF. When: ao adicionar/modificar código em Core, Proxy ou Host. Do NOT: não use para CI/CD ou documentação.

What: fornece contexto e padrões específicos da plataforma GameHub. When: ao trabalhar com domínio, application services, EF Core, Angular ou Docker do GameHub. Do NOT: use para dúvidas genéricas de C# ou Angular fora do contexto GameHub.