golang-error-handling SKILL.md skillA

golang-error-handling from yzfly/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yzfly/skills/golang-error-handling@v1.1.2

Pins v1.1.2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yzfly/skills
Path
skills/cto/references/payload/backend/golang/golang-error-handling/SKILL.md
Versions recorded
1
Latest version
v1.1.2, committed May 3, 2026
Size
6,578 bytes
Repository stars
12
License
a license file GitHub does not identify

Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel errors, panic/recover, the single handling rule, structured logging with slog, HTTP request logging middleware, and samber/oops for production errors. Built to make logs usable at scale with log aggregation 3rd-party tools. Apply when creating, wrapping, inspecting, or logging errors in Go code.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

**Persona:** You are a Go reliability engineer. You treat every error as an event that must either be handled or propagated with context — silent failures and duplicate logs are equally unacceptable.

**Modes:**

- **Coding mode** — writing new error handling code. Follow the best practices sequentially; optionally launch a background sub-agent to grep for violations in adjacent code (swallowed errors, log-and-return pairs) without blocking the main implementation.
- **Review mode** — reviewing a PR's error handling changes. Focus on the diff: check for swallowed errors, missing wrapping context, log-and-return pairs, and panic misuse. Sequential.
- **Audit mode** — auditing existing error handling across a codebase. Use up to 5 parallel sub-agents, each targeting an independent category (creation, wrapping, single-handling rule, panic/recover, structured logging).

> **Community default.** A company skill that explicitly supersedes `samber/cc-skills-golang@golang-error-handling` skill takes precedence.

# Go Error Handling Best Practices
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yzfly/skills/golang-error-handling@sha256:fe98980dbe14a2df

The line at the top of this page pins the label v1.1.2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tbew3htw4sf2oeqc.svg)](https://markdownregistry.com/a/art_tbew3htw4sf2oeqc)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 3, 2026.

versioncommittedcommitsizeaudit
v1.1.2 latest2026-05-03 c091e90 6,578 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6578 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

yzfly/skills · 12 stars · license a license file GitHub does not identify · pushed 2026-09-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tbew3htw4sf2oeqc
GET https://markdownregistry.com/api/v1/resolve?ref=yzfly/skills/golang-error-handling
GET https://markdownregistry.com/api/v1/blob/fe98980dbe14a2dfe3cfac5ebfe19462da338baaecdee4b09d8eb72b594341f0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from yzfly/skills

anti-ai-copy SKILL.md skill
yzfly/skills · skills/anti-ai-copy/SKILL.md · 软件界面文案(UI copy / microcopy / UX writing)写作与去 AI 味。当用户要写、改、审界面文案时使用:按钮、页面标题、表单标签、占位符、空状态、Toast /…
v1.0.0 · audit A · 12 stars
brand-narrative SKILL.md skill
yzfly/skills · skills/brand-narrative/SKILL.md · 品牌叙事策略。当用户要做品牌叙事 / 品牌故事 / 品牌定位 / 品牌策略、问「我们的品牌到底围绕什么」「该讲产品还是讲文化」、想判断某个新品 / 联名 / 内容「符不符合品牌」、或为 0–1…
v1.0.0 · audit A · 12 stars
breathing-brand SKILL.md skill
yzfly/skills · skills/breathing-brand/SKILL.md · 出海 / 国际化品牌的极简呼吸感视觉全案。当用户说要做品牌 VI、品牌视觉、logo 与周边、独立站视觉、社区 / 组织 / 产品的品牌形象,或抱怨自己的品牌「看起来廉价」「太满太乱」「不够国际化 /…
v1.0.0 · audit A · 12 stars
cto SKILL.md skill
yzfly/skills · skills/cto/SKILL.md · Startup / AI-startup CTO who is also a top-tier individual contributor. Two modes: (1) greenfield — turn fuzzy business…
git:20260504.146b163 · audit A · 12 stars
golang-benchmark SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-benchmark/SKILL.md · Golang benchmarking, profiling, and performance measurement. Use when writing, running, or comparing Go benchmarks…
v1.1.3 · audit A · 12 stars
golang-cli SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-cli/SKILL.md · Golang CLI application development. Use when building, modifying, or reviewing a Go CLI tool — especially for command…
v1.1.3 · audit A · 12 stars
golang-code-style SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-code-style/SKILL.md · Golang code style, formatting and conventions. Use when writing Go code, reviewing style, configuring linters, writing…
v1.1.2 · audit A · 12 stars
golang-concurrency SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-concurrency/SKILL.md · Golang concurrency patterns. Use when writing or reviewing concurrent Go code involving goroutines, channels, select…
v1.1.3 · audit A · 12 stars
golang-context SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-context/SKILL.md · Idiomatic context.Context usage in Golang — creation, propagation, cancellation, timeouts, deadlines, context values…
v1.1.1 · audit A · 12 stars
golang-continuous-integration SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-continuous-integration/SKILL.md · Provides CI/CD pipeline configuration using GitHub Actions for Golang projects. Covers testing, linting, SAST, security…
v1.2.0 · audit A · 12 stars
golang-data-structures SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-data-structures/SKILL.md · Golang data structures — slices (internals, capacity growth, preallocation, slices package), maps (internals, hash…
v1.1.1 · audit A · 12 stars
golang-database SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-database/SKILL.md · Comprehensive guide for Go database access. Covers parameterized queries, struct scanning, NULLable column handling…
v1.1.2 · audit A · 12 stars

Every file in yzfly/skills

Other files named golang-error-handling

golang-error-handling SKILL.md skill
samber/cc-skills-golang · skills/golang-error-handling/SKILL.md · Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel…
v1.3.1 · audit A · 3,523 stars
golang-error-handling SKILL.md skill
omarluq/librecode · .librecode/skills/golang-error-handling/SKILL.md · Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel…
v1.1.1 · audit A · 30 stars
golang-error-handling SKILL.md skill
codeready-toolchain/tarsy · .cursor/skills/golang-error-handling/SKILL.md · Error handling patterns for Go including error wrapping, custom errors, sentinel errors, and error checking best…
git:20260304.7bde6ac · audit A · 10 stars

Browse by kind, by grade A, or by owner.