go-sdk-bootstrap

Bootstrap Go services with trypanic/go-sdk wiring conventions.

Updated May 5, 2026
One-click install
npx skills add https://github.com/trypanic/skills --skill go-sdk-bootstrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: go-sdk-bootstrap
Source: https://github.com/trypanic/skills/tree/main/go-sdk-bootstrap
Command: npx skills add https://github.com/trypanic/skills --skill go-sdk-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually wiring a Go service with github.com/trypanic/go-sdk is error-prone due to non-obvious conventions like package identifier divergences (e.g. the postgres directory uses the database package name), strict constructor triplet rules, and required initialization order that cannot be inferred from standard Go documentation alone. This Skill eliminates that guesswork to ensure correct, production-ready setup.

Core Features & Use Cases

  • Canonical Wiring Rules: Encodes all go-sdk component mappings, package name divergences, and constructor usage (including the New / NewWithoutTracing / NewWithInstrumenter triplet) to avoid compile errors and misconfigured tracing/logging.
  • Verified Bootstrap Template: Provides a tested main.go template that follows correct initialization order (OTLP setup before logger init, shared resource pools, deferred shutdown in reverse construction order) for reliable service startup.
  • Guardrails & Best Practices: Includes strict errorkit error wrapping rules, a list of prohibited anti-patterns, and post-scaffold verification steps to ensure the service adheres to SDK standards.
  • Use Case: Ideal for Go teams building new services with trypanic/go-sdk, or developers adding go-sdk components to existing services who want to avoid common pitfalls and ensure consistent, maintainable code.

Quick Start

Use the go-sdk-bootstrap skill to scaffold a new Go service with logger, telemetry, postgres, and messaging wired correctly according to trypanic/go-sdk conventions.

Frequently Asked Questions about go-sdk-bootstrap

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

FAQPage Schema
How do I correctly initialize telemetry and logging in a Go service using trypanic go-sdk?

To correctly initialize telemetry and logging in a Go service, you must follow a strict initialization order, setting up OTLP before the logger and deferring shutdown in reverse construction order to ensure proper tracing behavior.

Why does my Go service fail to compile after adding postgres dependencies from go-sdk?

Your Go service fails to compile because the go-sdk postgres directory uses the database package name, creating a package identifier divergence that requires specific constructor triplet rules to resolve correctly.

What is the correct way to wrap errors using errorkit in a Go service?

The correct way to wrap errors using errorkit is to apply strict error wrapping rules that avoid prohibited anti-patterns, ensuring maintainable and production-ready service setup without broken tracing behavior.

Can I add go-sdk components to an existing Go service without breaking tracing behavior?

You can add go-sdk components to an existing Go service without breaking tracing behavior by following verified constructor triplet rules, including New, NewWithoutTracing, and NewWithInstrumenter, to ensure proper wiring.

What are the limitations of manually wiring trypanic go-sdk components in Go services?

Manually wiring trypanic go-sdk components introduces limitations such as non-obvious conventions and strict initialization sequences that cannot be inferred from standard Go documentation, leading to misconfigured tracing and logging.

What's the best way to scaffold a new Go service with postgres and messaging wired correctly?

The best way to scaffold a new Go service with postgres and messaging wired correctly is to use a verified main.go template that encodes canonical wiring rules and shared resource pools for reliable service startup.