Agent skill

go-sdk-specialist

Go SDK development with idiomatic patterns

Stars 514
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/sdk-platform-development/skills/go-sdk-specialist

SKILL.md

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

yaml
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

Expand your agent's capabilities with these related and highly-rated skills.

a5c-ai/babysitter

gsd-tools

Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).

514 31
Explore
a5c-ai/babysitter

model-profile-resolution

Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.

514 31
Explore
a5c-ai/babysitter

verification-suite

Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.

514 31
Explore
a5c-ai/babysitter

state-management

STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.

514 31
Explore
a5c-ai/babysitter

git-integration

Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.

514 31
Explore
a5c-ai/babysitter

frontmatter-parsing

YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.

514 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results