{"id":34882978,"url":"https://github.com/netresearch/go-development-skill","last_synced_at":"2026-04-02T16:27:27.424Z","repository":{"id":328941571,"uuid":"1115712301","full_name":"netresearch/go-development-skill","owner":"netresearch","description":"Agent Skill: Enterprise Go development patterns - resilient services, testing | Claude Code compatible","archived":false,"fork":false,"pushed_at":"2026-04-01T06:59:04.000Z","size":180,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-01T09:25:27.164Z","etag":null,"topics":["agent-skills","ai-agent","open-standard"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netresearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-CC-BY-SA-4.0","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-13T11:56:59.000Z","updated_at":"2026-04-01T06:59:07.000Z","dependencies_parsed_at":"2026-01-07T12:07:13.226Z","dependency_job_id":null,"html_url":"https://github.com/netresearch/go-development-skill","commit_stats":null,"previous_names":["netresearch/go-development-skill"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/netresearch/go-development-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgo-development-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgo-development-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgo-development-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgo-development-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/go-development-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgo-development-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31309882,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agent","open-standard"],"created_at":"2025-12-26T02:57:40.248Z","updated_at":"2026-04-02T16:27:27.415Z","avatar_url":"https://github.com/netresearch.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Go Development Skill\n\nProduction-grade Go development patterns for building resilient services, extracted from real-world projects including job schedulers, Docker integrations, and LDAP clients.\n\n## 🔌 Compatibility\n\nThis is an **Agent Skill** following the [open standard](https://agentskills.io) originally developed by Anthropic and released for cross-platform use.\n\n**Supported Platforms:**\n- ✅ Claude Code (Anthropic)\n- ✅ Cursor\n- ✅ GitHub Copilot\n- ✅ Other skills-compatible AI agents\n\n\u003e Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.\n\n\n## Features\n\n- **Architecture Patterns**: Package structure best practices, job abstraction hierarchy, configuration management (5-layer precedence), middleware chain pattern\n- **Cron Scheduling**: go-cron patterns — named jobs, runtime updates, per-entry context, resilience wrappers, observability, FakeClock testing\n- **Resilience Patterns**: Retry logic with exponential backoff, graceful shutdown, context propagation, error handling strategies\n- **Docker Integration**: Optimized Docker client patterns, buffer pooling for performance, container execution patterns\n- **LDAP Integration**: Active Directory patterns, user and group management, authentication flows\n- **Testing Strategy**: Test pyramid (unit/integration/e2e), build tags for test isolation, table-driven tests, comprehensive coverage\n- **Performance Optimization**: Buffer pooling, connection reuse, lazy initialization, context deadlines\n- **Observability**: Prometheus metrics integration, structured logging, error tracking\n\n## Installation\n\n### Marketplace (Recommended)\n\nAdd the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:\n\n```bash\n# Claude Code\n/plugin marketplace add netresearch/claude-code-marketplace\n```\n\n### npx ([skills.sh](https://skills.sh))\n\nInstall with any [Agent Skills](https://agentskills.io)-compatible agent:\n\n```bash\nnpx skills add https://github.com/netresearch/go-development-skill --skill go-development\n```\n\n### Download Release\n\nDownload the [latest release](https://github.com/netresearch/go-development-skill/releases/latest) and extract to your agent's skills directory.\n\n### Git Clone\n\n```bash\ngit clone https://github.com/netresearch/go-development-skill.git\n```\n\n### Composer (PHP Projects)\n\n```bash\ncomposer require netresearch/go-development-skill\n```\n\nRequires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).\n## Usage\n\nThis skill is automatically triggered when:\n\n- Building Go services or CLI applications\n- Implementing job scheduling or task orchestration\n- Integrating with Docker API\n- Building LDAP/Active Directory clients\n- Designing resilient systems with retry logic\n- Setting up comprehensive test suites\n- Implementing middleware patterns\n- Optimizing Go application performance\n\nExample queries:\n- \"Create a resilient job scheduler in Go\"\n- \"Implement Docker container execution with retry logic\"\n- \"Build LDAP authentication client\"\n- \"Set up graceful shutdown for Go service\"\n- \"Implement buffer pooling for high-throughput operations\"\n- \"Create comprehensive test suite with build tags\"\n\n## Structure\n\n```\ngo-development-skill/\n├── SKILL.md                              # Skill metadata and core patterns\n└── references/\n    ├── architecture.md                   # Package structure, patterns\n    ├── cron-scheduling.md                # go-cron: named jobs, updates, context, resilience\n    ├── resilience.md                     # Retry, shutdown, recovery\n    ├── docker.md                         # Docker client patterns\n    ├── ldap.md                           # LDAP/Active Directory integration\n    ├── testing.md                        # Test strategies and patterns\n    ├── linting.md                        # golangci-lint v2 configuration\n    ├── api-design.md                     # Bitmask options, functional options\n    ├── fuzz-testing.md                   # Go fuzzing patterns, security seeds\n    ├── mutation-testing.md               # Gremlins test quality measurement\n    ├── makefile.md                       # Standard Makefile interface\n    └── modernization.md                  # Go 1.26 modernizers, go fix, errors.AsType\n```\n\n## Expertise Areas\n\n### Architecture Patterns\n- Package structure best practices\n- Job abstraction hierarchy\n- Configuration management (5-layer precedence)\n- Middleware chain pattern\n\n### Cron Scheduling (go-cron)\n- Named jobs with O(1) lookup\n- Runtime updates (UpsertJob, UpdateSchedule, UpdateEntry)\n- Per-entry context with automatic cancellation\n- Resilience wrappers (retry, circuit breaker, timeout)\n- Observability hooks (Prometheus integration)\n- FakeClock for deterministic testing\n- Missed job catch-up policies\n\n### Resilience Patterns\n- Retry logic with exponential backoff\n- Graceful shutdown\n- Context propagation\n- Error handling strategies\n\n### Docker Integration\n- Optimized Docker client patterns\n- Buffer pooling for performance\n- Container execution patterns\n\n### LDAP Integration\n- Active Directory patterns\n- User and group management\n- Authentication flows\n\n### Testing Strategy\n- Test pyramid (unit/integration/e2e)\n- Build tags for test isolation\n- Table-driven tests\n- Comprehensive coverage\n\n## Configuration Management\n\n5-layer precedence pattern (highest priority last):\n\n1. Built-in defaults (hardcoded)\n2. Configuration file (INI, YAML, TOML)\n3. External source (Docker labels, K8s annotations)\n4. Command-line flags\n5. Environment variables (highest priority)\n\n## Testing Pyramid\n\n```\n       E2E Tests (~5-30s)        # Complete scenarios\n    Integration Tests (~1-5s)    # Real external deps\n  Unit Tests (~\u003c100ms)           # Mocked deps, fast\n```\n\n### Running Tests\n\n```bash\n# Unit tests only (default)\ngo test ./...\n\n# With integration tests\ngo test -tags=integration ./...\n\n# Full suite including E2E\ngo test -tags=e2e ./...\n\n# With race detector\ngo test -race ./...\n\n# With coverage\ngo test -coverprofile=coverage.out ./...\ngo tool cover -html=coverage.out\n```\n\n## Quality Gates\n\n### Recommended Tooling\n\n```makefile\n.PHONY: dev-check\ndev-check: fmt vet lint security test\n\nfmt:\n\tgofmt -w $(shell git ls-files '*.go')\n\tgci write .\n\nvet:\n\tgo vet ./...\n\nlint:\n\tgolangci-lint run --timeout 5m\n\nsecurity:\n\tgosec ./...\n\tgitleaks detect\n\ntest:\n\tgo test -race ./...\n```\n\n## Performance Optimization\n\n### Key Patterns\n\n1. **Buffer Pooling**: Reuse allocations with `sync.Pool`\n2. **Connection Reuse**: Single client instance, connection pooling\n3. **Lazy Initialization**: Initialize resources on first use\n4. **Context Deadlines**: Prevent runaway operations\n\n## Related Skills\n\nThis skill focuses on Go code patterns and quality. For complete project setup:\n\n| Skill | Purpose |\n|-------|---------|\n| `github-project` | Repository setup, branch protection, auto-merge workflows |\n| `enterprise-readiness` | OpenSSF Scorecard, SLSA provenance, signed releases |\n| `security-audit` | OWASP Top 10, CVE analysis, security hardening |\n\n## License\n\nThis project uses split licensing:\n\n- **Code** (scripts, workflows, configs): [MIT](LICENSE-MIT)\n- **Content** (skill definitions, documentation, references): [CC-BY-SA-4.0](LICENSE-CC-BY-SA-4.0)\n\nSee the individual license files for full terms.\n## Credits\n\nDeveloped and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).\n\n---\n\n**Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fgo-development-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Fgo-development-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fgo-development-skill/lists"}