resonate-basic-debugging-go

resonate-basic-debugging-go is a skill for Claude Code, Codex from resonatehq/resonate-skills. It costs 83 tokens per session (2,962 once invoked), scanned A, original, Apache-2.0.

A troubleshooting guide for Resonate workflows written with the Go software development kit. Resonate is a system for running workflows that can pause and continue later, including after a worker restarts.

In plain words
What is it for?
Use it when a Go Resonate workflow is stuck, replays incorrectly, cannot decode a promise, loses its heartbeat, or behaves differently because of the SDK version.
Why use it?
It helps identify execution-time problems such as workflows that never resume, repeated side effects during replay, and incorrectly encoded promises. It also covers connection, registration, and version-specific issues.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when a Go Resonate workflow is stuck, replays incorrectly, cannot decode a promise, loses its heartbeat, or behaves differently because of the SDK version.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/resonatehq/resonate-skills/resonate-basic-debugging-go
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add resonatehq/resonate-skills --skill resonate-basic-debugging-go
Clone the repo
git clone --depth 1 https://github.com/resonatehq/resonate-skills

Made for: Claude Code, Codex.

Wrote 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.

agentmods badge for resonate-basic-debugging-go

README.md
[![agentmods](https://agentmods.dev/badge/skills/resonatehq/resonate-skills/resonate-basic-debugging-go/github.svg)](https://agentmods.dev/skills/resonatehq/resonate-skills/resonate-basic-debugging-go)
Your own site
<a href="https://agentmods.dev/skills/resonatehq/resonate-skills/resonate-basic-debugging-go"><img src="https://agentmods.dev/badge/skills/resonatehq/resonate-skills/resonate-basic-debugging-go/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.

agentmods 80×15 button for resonate-basic-debugging-go

Your own site · 80×15
<a href="https://agentmods.dev/skills/resonatehq/resonate-skills/resonate-basic-debugging-go"><img src="https://agentmods.dev/badge/skills/resonatehq/resonate-skills/resonate-basic-debugging-go.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,962 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00083 $0.02962
Opus 5 $0.00042 $0.01481
Sonnet 5 $0.00017 $0.00592
Haiku 4.5 $0.00008 $0.00296

Measured 9d ago against content hash c4760ef9f691, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

resonate-basic-debugging-go 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 9d 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.

resonate-basic-debugging-go/SKILL.md · 249 lines

How it starts

The opening of the file, as written. The whole thing — 249 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Resonate Basic Debugging — Go

Version note. The Go SDK's first tagged release is 0.1.0. The tag is 0.1.0, not v0.1.0, so go get …@latest does not resolve to it — pin the tag explicitly: go get github.com/resonatehq/[email protected]. APIs may still change before a 1.0. Every code block here is verified against the 0.1.0 tag source and the resonatehq-examples/*-go repos.

Overview

Go's type system catches some bugs at compile time, but several Go-specific traps only surface at workflow-execution time. The most dangerous ones are silent: wrong leaf signatures, bad promise encoding, and r.Stop() on a live worker all fail without a clear error at the point of mistake. This skill is a symptom-first guide to those failure modes.

For the language-agnostic replay and recovery mental model, read durable-execution first.

Triage flow

  1. Is the worker connected? Confirm resonate.New did not return an error and that the correct URL/Network is set.
  2. Is the function registered? resonate.Register returns (RegisteredFunc, error) — unwrap and log.
  3. Is the promise stuck? Run resonate promise get <id> to check state (pending / resolved / rejected / timedout).
  4. Is the workflow replaying but producing duplicates? An un-checkpointed side effect is re-running above a durable boundary.
  5. Does Future.Await return a decode error after external settlement? Likely a resonate.NewValue encoding mismatch.
  6. Is the worker up but not picking up work? r.Stop() may have been called on a live worker.

Stuck / never-resuming workflows

Latent promise never settled

Symptom: Future.Await blocks indefinitely; resonate promise get <id> shows state pending.

Causes:

  • The external actor never called Promises().Resolve / PromiseSettle / resonate promise resolve <id>.
  • The promise was settled but the value encoding is wrong — Future.Await fails with a decode error and the workflow re-suspends.

Read the full file on GitHub · 249 lines

Changes

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.

  1. 9d ago First seen · 249 lines · 83 tokens per session scan A c4760ef9f691

Subscribe to this mod's changes

resonate-basic-debugging-go is a skill published in the GitHub repository resonatehq/resonate-skills (6 stars, last pushed 17d ago), licensed Apache-2.0. It adds 83 tokens to every session and 2,962 once invoked, about $0.0004 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-31.

Related

Other skills, from other repositories

go-linters

Add and validate custom Go analysis linters in gh-aw.

github/gh-aw · 17 tokens

printing-press-polish

Polish a generated CLI to pass verification and become publish-ready. Runs diagnostics (dogfood, verify, scorecard, go vet, gosec), automatically fixes all issues (verify failures, static-analysis findings, dead code, descriptions, README, MCP tool quality), reports the before/after delta, and offers to publish. Use…

mvanhorn/cli-printing-press · 125 tokens

stack-trace-go-probe

Internal helper for meta-stack-trace-investigator. Use when a Go panic or stack trace needs Go-specific nil/error checks, go test reproducer guidance, and patch targets.

opensquilla/opensquilla · 42 tokens

golang-troubleshooting

Troubleshoot Golang programs systematically - find and fix the root cause. Use when encountering bugs, crashes, deadlocks, races, or unexpected behavior in Go code. Covers debugging methodology, common Go pitfalls, test-driven debugging, pprof setup and capture, Delve, race detection, GODEBUG tracing, and production…

samber/cc-skills-golang · 175 tokens

golang-error-handling

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…

samber/cc-skills-golang · 144 tokens

sentry-go-sdk

Full Sentry SDK setup for Go. Use when asked to "add Sentry to Go", "install sentry-go", "setup Sentry in Go", or configure error monitoring, tracing, logging, metrics, or crons for Go applications. Supports net/http, Gin, Echo, Fiber, FastHTTP, Iris, Negroni, and gRPC.

getsentry/sentry-for-ai · 78 tokens