Skillget

golang-best-practices-skill

agent
SUMMARY

Production-ready Go code review skill for AI agents based on authoritative sources

README.md

Golang Fullstack Best Practices Skill

Comprehensive Go + GORM + PostgreSQL review skill for AI agents based on authoritative sources

License: MIT
Rules
Version
Domains

v3.0.0: The "Ultimate Merger" release. Unified 89 rules across 9 specialized domains, covering everything from Go concurrency and architecture to deep PostgreSQL performance and migration safety.

📋 Overview

This meta-skill provides a complete code review solution for Go fullstack backend services. It combines general Go language best practices (v2.1.0) with specialized GORM & PostgreSQL expertise (v1.0.0).

📚 Available Skills

Domain Rules Focus
Concurrency Safety 12 Goroutines, channels, race conditions
Clean Architecture 9 Layered architecture, gRPC, dependency inversion
Error Handling (Unified) 14 Go error chains + Postgres error codes/retries
Design Patterns 13 Code smells, refactoring, GoF patterns
Idiomatic Go 7 Go conventions, interface design, pointers
GORM Query Patterns 11 ORM queries, transactions, context
PostgreSQL Syntax 10 Raw SQL, Postgres-specific features
Query Performance 7 N+1 detection, indexing, EXPLAIN
Migration Safety 6 Zero-downtime schema changes, rollbacks

Priority Distribution:

  • 20 CRITICAL — Data loss, SQL injection, crashes, production bugs
  • 30 HIGH — Reliability, performance, architecture
  • 34 MEDIUM — Code quality, idiomatic patterns
  • 5 ARCHITECTURE — Structural compliance

🚀 Quick Start

Usage

Full Audit:

"Review this Go project for all language and database anti-patterns"

Targeted Reviews:

"Check for race conditions"              → Concurrency Safety
"Audit architecture"                     → Clean Architecture
"Review GORM queries for N+1"            → GORM Patterns / Query Performance
"Debug this 23505 Postgres error"        → Error Handling
"Is this migration safe for production?" → Migration Safety

🏗️ Structure

golang-fullstack-best-practices/
├── SKILL.md                    # Meta-skill coordinator (v3.0.0)
├── metadata.json               # Full rule manifest
│
├── concurrency-safety/         # Go-specific
├── clean-architecture/         # Architecture
├── design-patterns/            # Quality & Smells
├── idiomatic-go/               # Conventions
│
├── gorm-query-patterns/        # GORM ORM
├── postgresql-syntax/          # Raw SQL
├── query-performance/          # Optimization
├── migration-safety/           # DB Schema changes
│
├── error-handling/             # Unified Go & DB
├── shared/                     # Rule templates & categories
└── references/                 # Deep-dive guides

✨ Features

  • End-to-End Coverage: From Go syntax to PostgreSQL index optimization.
  • Unified Routing: High-accuracy targeting using meta-skill coordination.
  • Evidence-Based: Rules cite 8+ authoritative sources (Jon Bodner, Martin Fowler, Robert Martin, PostgreSQL Docs, etc.).
  • Production-Ready: Focused on zero-downtime, safe operations, and debugging real-world failures.

👤 Author

saifoelloh

Built with ❤️ for bulletproof Go systems.

Reviews (0)

No results found