Skip to content

henriqueatila/golang-gin-best-practices / skills/golang-gin-architect

golang-gin-architect

Verified

Software architect for Go Gin APIs. Use when making architecture decisions, evaluating complexity, designing systems, choosing patterns, or coordinating across gin skills.

FileKindSize
SKILL.mdskill md10.7 KB
metadata.jsonconfig466 B
references/adr-format-and-templates.mdmarkdown4.1 KB
references/adr-service-extraction-and-example.mdmarkdown4.0 KB
references/api-design-error-contract-docs.mdmarkdown1.8 KB
references/api-design-filtering-bulk-evolution.mdmarkdown3.8 KB
references/api-design-versioning-pagination.mdmarkdown4.3 KB
references/clean-architecture-feature-module.mdmarkdown4.5 KB
references/clean-architecture-layers-di.mdmarkdown5.2 KB
references/complexity-assessment-budget.mdmarkdown5.6 KB
references/complexity-assessment-gates.mdmarkdown4.2 KB
references/complexity-assessment-patterns.mdmarkdown5.0 KB
references/cross-cutting-health-checks.mdmarkdown1.7 KB
references/cross-cutting-observability.mdmarkdown3.9 KB
references/cross-cutting-security-config.mdmarkdown4.4 KB
references/data-ownership-boundaries.mdmarkdown4.5 KB
references/data-ownership-sync-migration.mdmarkdown4.3 KB
references/data-patterns-cqrs.mdmarkdown3.8 KB
references/data-patterns-event-sourcing-aggregate.mdmarkdown2.2 KB
references/data-patterns-event-store.mdmarkdown3.7 KB
references/data-patterns-outbox.mdmarkdown3.7 KB
references/data-patterns-read-replicas.mdmarkdown2.6 KB
references/data-patterns-saga.mdmarkdown3.6 KB
references/error-flow-domain-layers.mdmarkdown5.3 KB
references/error-flow-handler-chain.mdmarkdown4.7 KB
references/golden-main-medium-project.mdmarkdown3.0 KB
references/golden-main-medium-startup.mdmarkdown2.8 KB
references/golden-main-small-project.mdmarkdown4.0 KB
references/grpc-interop-gateway-docker.mdmarkdown2.1 KB
references/grpc-interop-server-client.mdmarkdown2.7 KB
references/grpc-interop-setup.mdmarkdown3.6 KB
references/messaging-consumer-docker.mdmarkdown1.6 KB
references/messaging-consumer-workqueues.mdmarkdown3.6 KB
references/messaging-dlq-idempotency.mdmarkdown3.1 KB
references/messaging-dlq-setup.mdmarkdown2.4 KB
references/messaging-pubsub-exchanges.mdmarkdown3.6 KB
references/messaging-rabbitmq-connection.mdmarkdown3.2 KB
references/messaging-rabbitmq-producer.mdmarkdown2.4 KB
references/object-storage-download-presign.mdmarkdown3.5 KB
references/object-storage-multipart-minio.mdmarkdown2.2 KB
references/object-storage-setup-upload.mdmarkdown4.2 KB
references/redis-cache-warming-pubsub.mdmarkdown3.2 KB
references/redis-caching-patterns.mdmarkdown4.3 KB
references/redis-session-distributed-lock.mdmarkdown3.9 KB
references/resilience-circuit-breaker-bulkhead.mdmarkdown4.3 KB
references/resilience-retry-rate-limiting.mdmarkdown4.0 KB
references/skill-orchestration-overview.mdmarkdown3.2 KB
references/skill-orchestration-workflows.mdmarkdown5.4 KB
references/system-design-bounded-contexts.mdmarkdown4.1 KB
references/system-design-c4-model.mdmarkdown4.6 KB
references/system-design-dependency-graphs.mdmarkdown2.6 KB
references/system-design-domain-modeling.mdmarkdown3.5 KB
references/system-design-project-structure.mdmarkdown4.2 KB
references/tech-debt-identification-prioritization.mdmarkdown5.1 KB
references/tech-debt-refactoring-communication.mdmarkdown4.0 KB

references/skill-orchestration-overview.md

View on GitHub
# Skill Orchestration — Overview and Decision Matrix

How and when to activate each skill in the gingo ecosystem.

Companion to `skill-orchestration-workflows.md` (common workflows, composition patterns, boundary rules).

---

## Skill Overview

| Skill | Domain | One-line Purpose |
|---|---|---|
| **golang-gin-architect** | Architecture | System design, complexity assessment, pattern selection, skill routing |
| **golang-gin-api** | HTTP Layer | Routing, handlers, binding, middleware, error handling |
| **golang-gin-auth** | Security | JWT, RBAC, login/register, token lifecycle, protected routes |
| **golang-gin-database** | Data Access | GORM/sqlx wiring, repository pattern, migrations tooling, transactions |
| **golang-gin-psql-dba** | Database | Schema design, index strategy, query optimization, extensions, migration safety |
| **golang-gin-testing** | Quality | Unit/integration/e2e tests, httptest, testcontainers, table-driven tests |
| **golang-gin-deploy** | Operations | Docker, docker-compose, Kubernetes, CI/CD, 12-factor config |

**Key distinction:**
- `golang-gin-database` = **how to write Go code** that talks to PostgreSQL (GORM, sqlx, repository pattern)
- `golang-gin-psql-dba` = **how to design and optimize PostgreSQL** (schemas, indexes, migrations, extensions)
- `golang-gin-architect` = **when to use what** and how skills compose together

---

## Decision Matrix

Use this to determine which skill(s) to activate for a given task.

### By Task Type

| Task | Primary Skill | May Also Need |
|---|---|---|
| "Create a new endpoint" | golang-gin-api | golang-gin-database, golang-gin-testing |
| "Add login/signup" | golang-gin-auth | golang-gin-api, golang-gin-database |
| "Design the schema" | golang-gin-psql-dba | golang-gin-database (migration tooling) |
| "Write repository code" | golang-gin-database | golang-gin-psql-dba (schema decisions) |
| "Query is slow" | golang-gin-psql-dba | golang-gin-database (query code) |
| "Add tests" | golang-gin-testing | (reads other skills for patterns) |
| "Dockerize the app" | golang-gin-deploy | — |
| "Set up CI/CD" | golang-gin-deploy | golang-gin-testing (test step) |
| "Should I use microservices?" | golang-gin-architect | — |
| "How to structure this feature?" | golang-gin-architect | golang-gin-api, golang-gin-database |
| "Add caching" | golang-gin-architect | golang-gin-api (middleware) |
| "Add full-text search" | golang-gin-psql-dba | golang-gin-database (Go code) |
| "Add WebSocket support" | golang-gin-api | — |
| "Rate limit endpoints" | golang-gin-api | — |
| "Set up monitoring" | golang-gin-deploy | golang-gin-architect (observability design) |

### By Keyword

| If the user mentions... | Activate |
|---|---|
| route, handler, middleware, binding, JSON response | golang-gin-api |
| JWT, token, login, signup, RBAC, permission, role | golang-gin-auth |
| GORM, sqlx, repository, migration tool, transaction | golang-gin-database |
| schema, index, EXPLAIN, ALTER TABLE, extension, pgvector, PostGIS | golang-gin-psql-dba |
| test, httptest, testcontainers, mock, coverage | golang-gin-testing |
| Docker, Kubernetes, CI/CD, deploy, helm, health check | golang-gin-deploy |
| architecture, microservice, monolith, CQRS, pattern, scale, design | golang-gin-architect |
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall