Borrowing it
Nothing to install: this file belongs to IceWhaleTech/ZimaOS-Blue. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/IceWhaleTech/ZimaOS-Blue/main/.agents/skills/golang-best-practices/SKILL.mdgit clone --depth 1 https://github.com/IceWhaleTech/ZimaOS-BlueWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/icewhaletech/zimaos-blue/golang-best-practices)<a href="https://agentmods.dev/skills/icewhaletech/zimaos-blue/golang-best-practices"><img src="https://agentmods.dev/badge/skills/icewhaletech/zimaos-blue/golang-best-practices/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/icewhaletech/zimaos-blue/golang-best-practices"><img src="https://agentmods.dev/badge/skills/icewhaletech/zimaos-blue/golang-best-practices.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00066 | $0.01827 |
| Opus 5 | $0.00033 | $0.00914 |
| Sonnet 5 | $0.00013 | $0.00365 |
| Haiku 4.5 | $0.00007 | $0.00183 |
Grade A, and why
golang-best-practices scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 267 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Golang Best Practices Skill
This skill provides coding standards and best practices for Golang development in this project.
Development Mode: TDD (Test-Driven Development)
This project strictly follows TDD. No exceptions.
The Iron Law
NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
Red-Green-Refactor Cycle
- RED - Write a failing test first
- Verify RED - Watch it fail (MANDATORY)
- GREEN - Write minimal code to pass
- Verify GREEN - Watch it pass (MANDATORY)
- REFACTOR - Clean up while keeping tests green
TDD Rules
- Write code before the test? Delete it. Start over.
- Test passes immediately? Fix the test.
- Can't explain why test failed? Stop and investigate.
- "I'll test after"? No. Tests-after prove nothing.
See superpowers/skills/test-driven-development/SKILL.md for complete TDD guidelines.
Database Design
1. Backward Compatibility
- Only add fields, never modify existing ones
- Ensure schema migrations are always forward-compatible
2. SQL Injection Prevention
- Always use ORM or parameterized queries
- Never concatenate user input into SQL strings
3. Primary Key Requirements
- Every table MUST have at least one primary key
- Prefer using an
idfield as primary key
4. File Path Storage
When storing file paths in database:
- If prefix matching is needed, always store paths with trailing
/ - CAUTION:
filepath.Base()returns empty string for paths ending with/ - Handle this edge case explicitly in code
Architecture Design
1. Trade-off Principle
There's no best solution, only the most suitable one for the current situation.
When facing multiple choices:
- Gather all evidence
- Compare pros/cons and ROI
- Choose the most appropriate solution
- Document the decision rationale
2. Avoid Over-Engineering
Say it three times: Don't over-design!
- Don't implement features that "might" be needed in the future
- Consider future migration paths and upgrade strategies
- But don't implement them until actually needed
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 12d ago First seen · 267 lines · 66 tokens per session scan A 288c3819b0c2
golang-best-practices is a skill published in the GitHub repository IceWhaleTech/ZimaOS-Blue (25 stars, last pushed 4mo ago), licensed MIT. It adds 66 tokens to every session and 1,827 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
pr-to-go-linter
Generate a new pkg/linters analyzer from a merged or open PR pattern.
golang-refactoring
Golang refactoring — safe, at-scale restructuring of existing Go code: a coverage-adaptive safety net, behavior-preserving transforms (gopls Rename/Extract, gofmt -r, gopatch), the Fowler catalog mapped to Go, breaking import cycles, and small stacked PRs. Apply when a function or type has grown too large, a code…
sapcc-review
Gold-standard SAP CC Go code review: 10 parallel domain specialists.
go-concurrency-safety
L1 supplement - audits Go-specific concurrency hazards in node client code: map iteration non-determinism, goroutine leaks, mutex ordering, panic boundaries, context cancellation.
design-review
Deep design review of Go codebase — naming, structure, consistency, interfaces, error handling. Scores each dimension and provides actionable fixes.
agents-md
Generate AGENTS.md files for Go, Rust, TypeScript, and Java projects. Use this skill whenever the user asks to create, scaffold, bootstrap, update, or review an AGENTS.md (or agent-instructions, CLAUDE.md, repo guide for agents) file in a codebase. Also trigger when the user says "add AGENTS.md", "make this repo…