go-development

Go Development Skill

Production-grade Go development patterns for building resilient services, extracted from real-world projects including job schedulers, Docker integrations, and LDAP clients.

🔌 Compatibility

This is an Agent Skill following the open standard originally developed by Anthropic and released for cross-platform use.

Supported Platforms:

• ✅ Claude Code (Anthropic)
• ✅ Cursor
• ✅ GitHub Copilot
• ✅ Other skills-compatible AI agents

Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.

Features

• Architecture Patterns: Package structure best practices, job abstraction hierarchy, configuration management (5-layer precedence), middleware chain pattern
• Cron Scheduling: go-cron patterns — named jobs, runtime updates, per-entry context, resilience wrappers, observability, FakeClock testing
• Resilience Patterns: Retry logic with exponential backoff, graceful shutdown, context propagation, error handling strategies
• Docker Integration: Optimized Docker client patterns, buffer pooling for performance, container execution patterns
• LDAP Integration: Active Directory patterns, user and group management, authentication flows
• Testing Strategy: Test pyramid (unit/integration/e2e), build tags for test isolation, table-driven tests, comprehensive coverage
• Performance Optimization: Buffer pooling, connection reuse, lazy initialization, context deadlines
• Observability: Prometheus metrics integration, structured logging, error tracking

Installation

Marketplace (Recommended)

Add the Netresearch marketplace once, then browse and install skills:

# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace

npx (skills.sh)

Install with any Agent Skills-compatible agent:

npx skills add https://github.com/netresearch/go-development-skill --skill go-development

Download Release

Download the latest release and extract to your agent's skills directory.

Git Clone

git clone https://github.com/netresearch/go-development-skill.git

Composer (PHP Projects)

composer require netresearch/go-development-skill

Requires netresearch/composer-agent-skill-plugin.

Usage

This skill is automatically triggered when:

• Building Go services or CLI applications
• Implementing job scheduling or task orchestration
• Integrating with Docker API
• Building LDAP/Active Directory clients
• Designing resilient systems with retry logic
• Setting up comprehensive test suites
• Implementing middleware patterns
• Optimizing Go application performance

Example queries:

• "Create a resilient job scheduler in Go"
• "Implement Docker container execution with retry logic"
• "Build LDAP authentication client"
• "Set up graceful shutdown for Go service"
• "Implement buffer pooling for high-throughput operations"
• "Create comprehensive test suite with build tags"

Structure

go-development-skill/
├── SKILL.md                              # Skill metadata and core patterns
└── references/
    ├── architecture.md                   # Package structure, patterns
    ├── cron-scheduling.md                # go-cron: named jobs, updates, context, resilience
    ├── resilience.md                     # Retry, shutdown, recovery
    ├── docker.md                         # Docker client patterns
    ├── ldap.md                           # LDAP/Active Directory integration
    ├── testing.md                        # Test strategies and patterns
    ├── linting.md                        # golangci-lint v2 configuration
    ├── api-design.md                     # Bitmask options, functional options
    ├── fuzz-testing.md                   # Go fuzzing patterns, security seeds
    ├── mutation-testing.md               # Gremlins test quality measurement
    ├── makefile.md                       # Standard Makefile interface
    └── modernization.md                  # Go 1.26 modernizers, go fix, errors.AsType

Expertise Areas

Architecture Patterns

• Package structure best practices
• Job abstraction hierarchy
• Configuration management (5-layer precedence)
• Middleware chain pattern

Cron Scheduling (go-cron)

• Named jobs with O(1) lookup
• Runtime updates (UpsertJob, UpdateSchedule, UpdateEntry)
• Per-entry context with automatic cancellation
• Resilience wrappers (retry, circuit breaker, timeout)
• Observability hooks (Prometheus integration)
• FakeClock for deterministic testing
• Missed job catch-up policies

Resilience Patterns

• Retry logic with exponential backoff
• Graceful shutdown
• Context propagation
• Error handling strategies