googlecloudplatform/go-project-setup
agents/skills/go-project-setup/SKILL.md
Standardized setup for new Go (Golang) projects and services. Activate to ensure clean, idiomatic project structures (Standard Layout) and implement production-ready patterns (graceful shutdown, package separation) from day one.
$ install --global
skillsauthnpx skillsauth add googlecloudplatform/devrel-demos go-project-setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 1:59 PM7.1s11 files scanned
SKILL.md
- name:
- go-project-setup
- description:
- >
Go Project Setup
This skill guides the creation of clean, idiomatic Go project structures.
Core Mandates
- Standard Layout Only: Use the official Go project layout (
cmd/,internal/).- NEVER create a
pkg/directory. (It is an anti-pattern common in Kubernetes but not idiomatic Go).
- NEVER create a
- Flat by Default: Start with a flat structure (all files in root) for simple apps. Only introduce
cmd/andinternal/when multiple binaries or private packages are needed. - Modern Go: Ensure
go.modspecifies the latest stable Go version (currently 1.24+).
Workflow
1. Determine Scope
Ask the user: "Is this a simple tool, a library, or a multi-service repo?"
2. Select and Use Template
MANDATORY: You MUST read and use the templates provided in the assets/ directory. They establish idiomatic patterns like graceful shutdown, run functions, and package separation.
- Simple CLI / Tool:
assets/cli-simple. Flat structure. - Cobra CLI:
assets/cli-cobra. For complex CLI tools. - Library:
assets/library. Package in root,internal/for hidden logic. - Application / Service:
assets/webservice.cmd/app-name/main.go: Entry point using therunfunction pattern.internal/: Private application logic.
- MCP Server:
assets/mcp-server. - Game:
assets/game. Using Ebitengine.
3. Initialize
- Create Directory:
mkdir my-app - Init Module:
go mod init github.com/user/my-app - Linting: (Optional) Initialize
.golangci.ymlif the project requires rigorous style enforcement. - Apply Template: Copy and adapt the files from the chosen template in
assets/. Ensure module names are updated. - Verify: Run
go mod tidyandgo build ./....
References
references/project_layout.md: Official Go Module Layout guide.
Related Skills
googlecloudplatform/gcp-agent-sdp-template-factory
devops
VerifiedTrustedCommunity
Standardizes the creation of Sensitive Data Protection (DLP) templates for PII and credential redaction.
260SKILL.mdUpdated Apr 5, 2026
googlecloudplatform/gcp-agent-safety-gatekeeper
development
VerifiedTrustedCommunity
Implements the "Defense-in-Depth" integration pattern in Python (intercepting prompts, parsing filter results).
260SKILL.mdUpdated Apr 5, 2026
googlecloudplatform/gcp-agent-model-armor-shield
testing
VerifiedTrustedCommunity
Configures Model Armor security policies (Prompt Injection, Jailbreak, RAI filters).
260SKILL.mdUpdated Apr 5, 2026
googlecloudplatform/gcp-agent-golden-dataset-builder
tools
VerifiedTrustedCommunity
Assists developers in collecting and structuring a library of diverse examples ("Golden Dataset") required for data-driven evaluation, including tool trajectories.
260SKILL.mdUpdated Apr 5, 2026