
Version releases using git tags following semantic versioning. Trigger: When creating releases, tagging versions, or managing version numbers.
Create well-structured git commits following conventional commits. Trigger: When committing changes, writing commit messages, or staging files.
Local development workflow: Makefiles, port conventions, running services, and environment setup. Trigger: When adding new services, updating Makefiles, configuring local ports, or setting up local development.
Naming conventions for relational databases: databases, tables, columns, indexes, constraints, and enums. Applies to SQL migrations, sqlc queries, and ER diagrams in Mermaid. Trigger: When creating database tables, writing migrations, designing ER diagrams, or naming columns and constraints.
Design tokens for consistent spacing, sizes, and radii across Flutter UI components. Trigger: When creating UI components, reviewing spacing/sizing, or eliminating magic numbers.
GoRouter navigation patterns for Flutter: routing, auth guards, deep links, shell routes, and redirect logic. Trigger: When adding routes, implementing auth guards, configuring deep links, or managing navigation in the mobile app.
Test-Driven Development for Flutter: red-green-refactor cycle for domain entities, value objects, use cases, repositories, and Riverpod notifiers. Trigger: When writing unit tests, implementing TDD, creating mocks, or testing business logic in the Flutter app.
Widget and component testing for Flutter: pumping widgets, finders, matchers, interaction simulation, golden tests, and accessibility checks. Trigger: When writing widget tests, testing UI components, creating golden tests, or verifying accessibility in Flutter.
GitHub Actions CI/CD conventions for Nx monorepos: affected-based pipelines, changed-file detection, matrix jobs for renderable artifacts, Go service testing, and artifact bundling. Trigger: When creating or modifying GitHub Actions workflows, adding CI for new Nx projects, or optimizing pipeline execution.
Resilience patterns for Go microservices: circuit breaker, retry with backoff, timeouts, graceful degradation, and failure injection testing. Trigger: When implementing circuit breakers, adding retry logic, configuring timeouts, or testing service resilience under failure.
Diagnose and fix LaTeX compilation errors using CI error logs committed to the repo. Trigger: When a LaTeX document fails to compile in CI, when .errlog files exist, or when user asks to fix a broken LaTeX build.
Create and maintain AGENTS.md files for services, components, and subagents with scoped skill references and hierarchical context. Trigger: When creating AGENTS.md for a new service or component, updating existing AGENTS.md, or defining subagent context boundaries.
Define corporate color palettes based on Catppuccin warm tones with light/dark mode conventions. Trigger: When defining brand colors, creating theme systems, or implementing light/dark modes.
End-to-end API testing with Bruno HTTP client: collection organization, environment variables, test scripts, and CI integration. Trigger: When creating E2E API tests, organizing Bruno collections, or setting up API test automation.
Write clear, structured documentation for any project. Trigger: When writing READMEs, API docs, user guides, or technical documentation.
Atomic Design system for Flutter with 5 levels: atoms, molecules, organisms, templates, and pages for consistent UI. Trigger: When creating UI components, building screens, or reviewing component hierarchy in the mobile app.
Riverpod state management patterns for Flutter: providers, notifiers, async state, and clean architecture integration. Trigger: When creating Riverpod providers, managing async state, or connecting UI to business logic in the mobile app.
Verifiable UX and UI rules for Flutter: touch targets, contrast, spacing, component states, accessibility, and visual consistency. Trigger: When creating UI components, reviewing screens for UX compliance, or checking accessibility standards.
API documentation with OpenAPI/Swagger generated from code annotations, plus service-level README conventions. Trigger: When documenting API endpoints, generating Swagger specs, or writing service documentation.
Inter-service communication with gRPC and Protocol Buffers: contract definition, code generation, client/server patterns. Trigger: When creating gRPC services, defining protobuf contracts, or implementing service-to-service communication.
Load testing with k6 for Go microservices: smoke, load, stress, spike, and soak tests with pass/fail thresholds. Trigger: When writing load tests, running stress tests, validating performance thresholds, or benchmarking endpoints.
Cloud-agnostic object storage with abstract interfaces and implementations for S3, GCS, and MinIO. Trigger: When storing files, logs, metrics exports, backups, or any binary objects in cloud storage.
Service bootstrap in Go: manual dependency injection, environment-based configuration, composition root wiring, graceful shutdown, and multi-environment conventions. Trigger: When wiring dependencies in main.go, setting up configuration, managing secrets, or configuring environment-specific behavior.
Generate LaTeX corporate documents following project writing conventions and corporate color palette. Trigger: When creating LaTeX documents, reports, proposals, or any formal PDF deliverable.
Add and maintain version control tables in LaTeX corporate documents. Trigger: When creating new LaTeX documents, updating document versions, or reviewing document history.
Create Mermaid diagrams following project conventions: domain-based organization, filename prefixes by diagram type, and software engineering best practices. Trigger: When creating diagrams, flowcharts, sequence diagrams, ER diagrams, or any visual documentation in Mermaid.
Conventions for writing project documents: technical language, medium complexity, Chilean peso economics, and structured output under docs/. Trigger: When generating project documents, proposals, reports, or any formal deliverable.
Creates new AI agent skills following the Agent Skills spec. Trigger: When user asks to create a new skill, add agent instructions, or document patterns for AI.
TypeScript strict patterns and best practices. Trigger: When implementing or refactoring TypeScript in .ts/.tsx (types, interfaces, generics, const maps, type guards, removing any, tightening unknown).
Fundamental UX laws and principles from lawsofux.com for designing better interfaces. Trigger: When designing UI flows, reviewing UX decisions, or justifying design choices.
Review Flutter components and screens for UX/UI compliance. Trigger: When user invokes /ux-review command or requests UX audit.
Test-Driven Development workflow in Go: red-green-refactor cycle, table-driven tests, mocks via interfaces, integration tests with testcontainers, and contract tests between services. Trigger: When writing tests, implementing TDD, creating mocks, setting up integration tests, or creating contract tests.
Syncs skill metadata to AGENTS.md Auto-invoke sections. Trigger: After creating/modifying skills, regenerating Auto-invoke tables, or troubleshooting missing skills in AGENTS.md.
DartDoc documentation conventions for Flutter/Dart code: classes, methods, parameters, examples, and linting rules. Trigger: When writing or reviewing documentation comments in Dart/Flutter files.
Terraform security practices: sensitive variables, secret management, state protection, .gitignore patterns, and CI/CD credential handling. Trigger: When handling secrets in Terraform, configuring state backends, reviewing .gitignore for Terraform, or setting up CI/CD pipelines for infrastructure.
Language-agnostic Clean Architecture principles: dependency rule, layer separation, ports & adapters, screaming architecture, and bounded contexts. Trigger: When designing service architecture, reviewing layer boundaries, onboarding to the codebase, or deciding where code belongs.
Cloud-agnostic asynchronous messaging with abstract interfaces and implementations for NATS, RabbitMQ, and Google Pub/Sub. Trigger: When implementing event-driven communication, publishing domain events, or creating event subscribers.
Terraform code conventions: file organization, naming, variables, outputs, formatting, and the plan/apply workflow. Trigger: When writing Terraform files, reviewing HCL code style, organizing .tf files, or adding new Terraform modules.
Scaffold Flutter features with screaming + clean architecture: domain-driven directories, layered separation, and project conventions. Trigger: When creating a new feature/domain, adding layers to an existing feature, or reviewing mobile app structure.
HTTP handler patterns with Gin framework: routing, middleware, validation, error handling, and API versioning. Trigger: When creating HTTP endpoints, adding middleware, handling request validation, or standardizing error responses.
Cloud-agnostic persistence layer with sqlc for type-safe SQL, repository interfaces, in-memory implementation, and migration conventions. Trigger: When implementing data persistence, creating repositories, writing migrations, or setting up database connections.
Testing philosophy and strategy for every feature: test pyramid, mandatory levels per change type, completion checklist, and skill delegation. Trigger: When planning tests for a feature, reviewing test coverage, defining acceptance criteria, or asking what tests a change needs.
Scaffold a new Go microservice: directory structure, naming conventions, file layout, and step-by-step creation guide following clean architecture. Trigger: When creating a new microservice, adding a new domain, or reviewing service structure.
Configure multi-environment setup for Expo apps with EAS Build. Trigger: When setting up dev/staging/production environments, configuring environment variables, or creating EAS build profiles.
Create GitHub issues in Spanish following project conventions: structured sections, conventional title prefixes, and consistent labeling. Trigger: When creating GitHub issues, reporting bugs, or proposing features via gh CLI.
Vendor-neutral observability with OpenTelemetry: structured logging (slog), distributed tracing, metrics, and export to object storage. Trigger: When adding logging, tracing, metrics, or configuring observability pipelines in microservices.