golang-samber-oops SKILL.md skillA

golang-samber-oops from omarluq/librecode is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add omarluq/librecode/golang-samber-oops@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
omarluq/librecode
Path
.librecode/skills/golang-samber-oops/SKILL.md
Versions recorded
1
Latest version
v1.1.2, committed May 17, 2026
Size
9,935 bytes
Repository stars
30
License
MIT

Structured error handling in Golang with samber/oops — error builders, stack traces, error codes, error context, error wrapping, error attributes, user-facing vs developer messages, panic recovery, and logger integration. Apply when using or adopting samber/oops, or when the codebase already imports github.com/samber/oops.

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 engineer who treats errors as structured data. Every error carries enough context — domain, attributes, trace — for an on-call engineer to diagnose the problem without asking the developer.

# samber/oops Structured Error Handling

**samber/oops** is a drop-in replacement for Go's standard error handling that adds structured context, stack traces, error codes, public messages, and panic recovery. Variable data goes in `.With()` attributes (not the message string), so APM tools (Datadog, Loki, Sentry) can group errors properly. Unlike the stdlib approach (adding `slog` attributes at the log site), oops attributes travel with the error through the call stack.

## Why use samber/oops

Standard Go errors lack context — you see `connection failed` but not which user triggered it, what query was running, or the full call stack. `samber/oops` provides:

- **Structured context** — key-value attributes on any error
- **Stack traces** — automatic call stack capture
- **Error codes** — machine-readable identifiers
- **Public messages** — user-safe messages separate from technical details
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add omarluq/librecode/golang-samber-oops@sha256:f9acc650c5817bd9

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_ejn5yoh7q4iu5lqc.svg)](https://markdownregistry.com/a/art_ejn5yoh7q4iu5lqc)

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

Versions

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

versioncommittedcommitsizeaudit
v1.1.2 latest2026-05-17 6dddbce 9,935 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 (9935 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

omarluq/librecode · 30 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ejn5yoh7q4iu5lqc
GET https://markdownregistry.com/api/v1/resolve?ref=omarluq/librecode/golang-samber-oops
GET https://markdownregistry.com/api/v1/blob/f9acc650c5817bd90b1cbaead2e6b3ed4406f3360a7aba10940bedb478179904

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 omarluq/librecode

autofix SKILL.md skill
omarluq/librecode · .librecode/skills/autofix/SKILL.md · Safely review and apply CodeRabbit PR review-thread feedback from GitHub with per-change approval; never execute…
v0.1.0 · audit B · 30 stars
code-review SKILL.md skill
omarluq/librecode · .librecode/skills/code-review/SKILL.md · AI-powered code review using CodeRabbit. Default code-review skill. Trigger for any explicit review request AND…
v0.1.0 · audit A · 30 stars
conventional-git SKILL.md skill
omarluq/librecode · .librecode/skills/conventional-git/SKILL.md · Conventional Commits v1.0.0 branch naming, worktree naming, and commit message standards for GitHub and GitLab…
v1.2.0 · audit A · 30 stars
deep-research SKILL.md skill
omarluq/librecode · .librecode/skills/deep-research/SKILL.md · Deep research skill — broad parallel web searches, multi-source validation, confidence tracking, cited Markdown report…
v1.1.0 · audit A · 30 stars
golang-benchmark SKILL.md skill
omarluq/librecode · .librecode/skills/golang-benchmark/SKILL.md · Golang benchmarking, profiling, and performance measurement. Use when writing, running, or comparing Go benchmarks…
v1.1.3 · audit A · 30 stars
golang-cli SKILL.md skill
omarluq/librecode · .librecode/skills/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 · 30 stars
golang-code-style SKILL.md skill
omarluq/librecode · .librecode/skills/golang-code-style/SKILL.md · Golang code style, formatting and conventions. Use when writing code, reviewing style, configuring linters, writing…
v1.1.1 · audit A · 30 stars
golang-concurrency SKILL.md skill
omarluq/librecode · .librecode/skills/golang-concurrency/SKILL.md · Golang concurrency patterns. Use when writing or reviewing concurrent Go code involving goroutines, channels, select…
v1.1.2 · audit A · 30 stars
golang-context SKILL.md skill
omarluq/librecode · .librecode/skills/golang-context/SKILL.md · Idiomatic context.Context usage in Golang — creation, propagation, cancellation, timeouts, deadlines, context values…
v1.1.1 · audit A · 30 stars
golang-continuous-integration SKILL.md skill
omarluq/librecode · .librecode/skills/golang-continuous-integration/SKILL.md · Provides CI/CD pipeline configuration using GitHub Actions for Golang projects. Covers testing, linting, SAST, security…
v1.1.2 · audit A · 30 stars
golang-data-structures SKILL.md skill
omarluq/librecode · .librecode/skills/golang-data-structures/SKILL.md · Golang data structures — slices (internals, capacity growth, preallocation, slices package), maps (internals, hash…
v1.1.1 · audit A · 30 stars
golang-database SKILL.md skill
omarluq/librecode · .librecode/skills/golang-database/SKILL.md · Comprehensive guide for Go database access. Covers parameterized queries, struct scanning, NULLable column handling…
v1.1.2 · audit A · 30 stars

Every file in omarluq/librecode

Other files named golang-samber-oops

golang-samber-oops SKILL.md skill
samber/cc-skills-golang · skills/golang-samber-oops/SKILL.md · Structured error handling in Golang with samber/oops — error builders, stack traces, error codes, error context, error…
v1.2.1 · audit A · 3,816 stars
golang-samber-oops SKILL.md skill
yzfly/skills · skills/cto/references/payload/backend/golang/golang-samber-oops/SKILL.md · Structured error handling in Golang with samber/oops — error builders, stack traces, error codes, error context, error…
v1.1.2 · audit A · 12 stars

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