The Complete Production SOP: How to Deploy and Run Echo Extensible High-Performance Go HTTP Framework in Autonomous AI Agents

---
name: "echo-high-performance-go-rest"
description: "Develop fast, scalable RESTful web APIs in Go using the feature-packed Echo framework."
metadata:
  author: "Labstack"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "setup echo server go"
  - "custom validator echo"
  - "echo group middleware"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Echo Extensible High-Performance Go HTTP Framework

Configures Labstack Echo: context methods (c.JSON, c.String), custom binders and validators, group-level middleware, HTTP error handling (echo.HTTPErrorHandler), and automated WebSocket support.

## When to Invoke
Invoke this skill whenever you need to:
- setup echo server go
- custom validator echo
- echo group middleware

## Execution SOP & Rules
1. Initialize: e := echo.New(); e.Use(middleware.Logger(), middleware.Recover()).
2. Configure validator: e.Validator = &CustomValidator{validator: validator.New()}.
3. Handle request: e.POST('/users', func(c echo.Context) error { ... return c.JSON(201, user) }).
4. Start server gracefully with http.Server shutdown signal listening.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.

package validator

import (
	"net/http"
	"github.com/go-playground/validator/v10"
	"github.com/labstack/echo/v4"
)

type CustomValidator struct {
	Validator *validator.Validate
}

func (cv *CustomValidator) Validate(i interface{}) error {
	if err := cv.Validator.Struct(i); err != nil {
		return echo.NewHTTPError(http.StatusBadRequest, err.Error())
	}
	return nil
}

package main

import (
	"context"
	"net/http"
	"os"
	"os/signal"
	"syscall"
	"time"

	"github.com/go-playground/validator/v10"
	"github.com/labstack/echo/v4"
	"github.com/labstack/echo/v4/middleware"
)

type CustomValidator struct {
	Validator *validator.Validate
}

func (cv *CustomValidator) Validate(i interface{}) error {
	if err := cv.Validator.Struct(i); err != nil {
		return echo.NewHTTPError(http.StatusBadRequest, err.Error())
	}
	return nil
}

func main() {
	e := echo.New()
	e.HideBanner = true
	e.Validator = &CustomValidator{Validator: validator.New()}

	e.Use(middleware.Logger())
	e.Use(middleware.Recover())

	// Public Routes
	e.GET("/health", func(c echo.Context) error {
		return c.JSON(http.StatusOK, map[string]string{"status": "healthy"})
	})

	// Scoped Group Middleware
	v1 := e.Group("/api/v1")
	// Protected Subgroup
	admin := v1.Group("/admin", middleware.KeyAuth(func(key string, c echo.Context) (bool, error) {
		return key == os.Getenv("ADMIN_API_KEY"), nil
	}))
	admin.GET("/metrics", func(c echo.Context) error {
		return c.String(http.StatusOK, "metrics:ok")
	})

	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
	defer stop()

	go func() {
		if err := e.Start(":8080"); err != nil && err != http.ErrServerClosed {
			e.Logger.Fatal("shutting down server:", err)
		}
	}()

	<-ctx.Done()
	shutdownCtx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
	defer cancel()
	if err := e.Shutdown(shutdownCtx); err != nil {
		e.Logger.Fatal(err)
	}
}

#!/usr/bin/env bash
set -euo pipefail
echo "Checking formatting..."
gofmt -s -w cmd/ internal/
echo "Running vet checks..."
go vet ./...
echo "Running tests with data race detector..."
go test -race -timeout 30s ./...
echo "Verification successful!"