OpenParable
Skip to content
← Back to skills

Go SDK Specialist

Development
go-sdk-specialist

Go SDK Specialist is an Agent Skill for development published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Go SDK development with idiomatic patterns

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/sdk-platform-development/skills/go-sdk-specialist/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/go-sdk-specialist, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Go SDK Specialist Skill

Overview

This skill specializes in developing idiomatic Go SDKs with proper module versioning, context-based cancellation, and Go-style error handling patterns.

Capabilities

  • Design Go SDK architecture with proper module structure
  • Implement context-based cancellation and timeouts
  • Apply Go error handling patterns with wrapped errors
  • Configure go.mod versioning following semver
  • Design functional options pattern for configuration
  • Implement interface-based design for testability
  • Configure proper logging with structured output
  • Support concurrent operations safely

Target Processes

  • Multi-Language SDK Strategy
  • SDK Architecture Design
  • SDK Testing Strategy

Integration Points

  • Go modules (go.mod)
  • go test with testify
  • golangci-lint for code quality
  • pkg.go.dev for documentation
  • goreleaser for releases

Input Requirements

  • API specification
  • Module path (e.g., github.com/org/sdk)
  • Minimum Go version
  • Concurrency requirements
  • Error handling preferences

Output Artifacts

  • Go module source code
  • go.mod and go.sum files
  • Test files (*_test.go)
  • Examples in examples/ directory
  • README with installation instructions
  • GoDoc-compatible documentation

Usage Example

skill:
  name: go-sdk-specialist
  context:
    apiSpec: ./openapi.yaml
    modulePath: github.com/myorg/sdk-go
    goVersion: "1.21"
    useGenerics: true
    errorWrapping: true
    functionalOptions: true

Best Practices

  1. Use functional options for configuration
  2. Accept interfaces, return structs
  3. Make zero values useful
  4. Handle errors explicitly with wrapping
  5. Use context.Context for cancellation
  6. Keep packages focused and small