health-check-design

Design health and readiness endpoints for Go services with Kubernetes probes.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/shafibabar/SDLC-Artifact-Factory --skill health-check-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health-check-design
Source: https://github.com/shafibabar/SDLC-Artifact-Factory/tree/main/skills/health-check-design
Command: npx skills add https://github.com/shafibabar/SDLC-Artifact-Factory --skill health-check-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents self-inflicted outages and cascading failures by teaching you how to correctly implement and distinguish between liveness, readiness, and startup probes in Go services.

Core Features & Use Cases

  • Probe Semantics: Learn the critical distinction between liveness (process health) and readiness (traffic-readiness/dependency health).
  • Graceful Shutdown: Implement the not-ready-on-shutdown pattern to ensure zero dropped requests during deployments.
  • Use Case: Use this to configure your Go service so that Kubernetes can safely route traffic, perform rolling updates without dropping connections, and avoid restart-looping healthy services during transient dependency blips.

Quick Start

Use the health-check-design skill to generate the readiness handler and probe configuration for a new Go service.

Frequently Asked Questions about health-check-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the difference between liveness and readiness probes in Kubernetes?

Liveness probes check process health to trigger restarts, while readiness probes check traffic-readiness and dependency health to route traffic. This Skill implements both for Go services to prevent restart-looping and ensure reliable traffic routing.

How do I implement graceful shutdown in a Go service to avoid dropped requests?

Implement graceful shutdown in Go by applying the not-ready-on-shutdown pattern to fail readiness probes. This Skill designs the handler and aligns termination grace periods to ensure Kubernetes performs rolling updates without dropping active connections.

Why does my Kubernetes pod restart when a dependency becomes unavailable?

Your pod restarts because the liveness probe is incorrectly checking dependency health instead of process health. This Skill separates liveness and readiness checks so transient dependency blips only remove the pod from service, avoiding self-inflicted restart loops.

How do I configure a startup probe for a Go service with slow initialization?

Configure a startup probe to delay liveness checks until Go service initialization completes. This Skill designs startup, liveness, and readiness probe configurations to manage the full service lifecycle and prevent premature restarts during boot.

Do I need external dependencies to monitor service health in Go?

No, this Skill implements dependency-free liveness checks in Go. It designs timeout-bounded readiness probes that monitor dependency health without requiring external libraries.

What is the best way to configure Kubernetes health checks for backend Go services?

The best way is distinguishing liveness, readiness, and startup probes to match the Go service lifecycle. This Skill designs production-ready health endpoints and probe configurations for zero-downtime deployments and reliable traffic routing.