Which Go frameworks are compatible with this skill?

This skill is specifically optimized for the Echo web framework and the pgx PostgreSQL driver, utilizing a layered architecture approach.

What is the recommended project structure?

The skill follows a strict directory structure: /internal/handlers for HTTP logic, /internal/services for business logic, and /internal/repository for data access.

How does this skill handle database transactions?

It implements a Repository pattern that utilizes pgx's Begin and Commit/Rollback methods to ensure atomic operations across multiple SQL queries.

Can I use this for complex data filtering?

Yes, the skill includes a dedicated QueryBuilder pattern designed to handle dynamic SQL generation for complex filters, including IN conditions, date ranges, and text search.

Does it include error handling for API responses?

Yes, it provides a standardized APIResponse model that differentiates between validation errors (400 Bad Request) and operational errors (500 Internal Server Error).

Go Backend Service Patterns

Name: Go Backend Service Patterns
Author: linehaul-ai

bylinehaul-ai

•

API Development

Implements production-grade API endpoints, business logic layers, and PostgreSQL operations using the Go Echo framework.

About

This skill provides a comprehensive architectural framework for building scalable Go backends using the Echo framework and pgx driver. It enforces a clean, layered architecture—Handlers, Services, and Repositories—to ensure strict separation of concerns and maintainable code. Designed specifically for complex systems like laneweaverTMS, it offers standardized patterns for dependency injection, transaction management, dynamic SQL query building, and robust error handling, allowing developers to accelerate the creation of RESTful services while maintaining high code quality.

Key Features

Layered architecture (Handler-Service-Repository) for clear separation of concerns
Standardized HTTP request binding, validation, and API response structures
Production-ready retry logic for handling database race conditions and unique constraints
Advanced database transaction management using the pgx PostgreSQL driver
1 GitHub stars
Dynamic QueryBuilder for complex multi-parameter filtering and pagination

Use Cases

Developing RESTful API endpoints for enterprise-grade transportation management systems
Building advanced search interfaces with multi-select filters and date range queries
Implementing complex business orchestration logic with high transactional integrity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add linehaul-ai/linehaulai-claude-marketplace backend-service-patterns

For use in Claude.ai and ChatGPT

Download Skill

GitHub