Agent skill

System Bridge Go Backend

by timmo001 in timmo001/system-bridge

System Bridge Go backend conventions - error wrapping, graceful degradation for data modules, nil-pointer safety, context-aware Module.Update, structured slog logging, and errcheck-clean deferred…

Apache-2.0Auto-check passedBackend & APIs

Install System Bridge Go Backend

skills CLI
$ npx skills add timmo001/system-bridge --skill system-bridge-go-backend -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install timmo001/system-bridge system-bridge-go-backend --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/timmo001/system-bridge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/system-bridge-go-backend .claude/skills/system-bridge-go-backend && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
system-bridge-go-backend
GitHub stars
356
Token cost
~841 tokens
SKILL.md length
223 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

System Bridge Go backend conventions - error wrapping, graceful degradation for data modules, nil-pointer safety, context-aware Module.Update, structured slog logging, and errcheck-clean deferred…

  • Reviewing Go code in the system-bridge backend (data modules
  • SKILL.md covers Format and Lint, File Naming, Error Handling and Graceful Degradation, plus 4 more sections
  • Calls go and mise
  • HTTP/WebSocket APIs

What it does

System Bridge Go Backend is an agent skill from timmo001/system-bridge. System Bridge Go backend conventions - error wrapping, graceful degradation for data modules, nil-pointer safety, context-aware Module.Update, structured slog logging, and errcheck-clean deferred cleanup. Use when writing or reviewing Go code in the system-bridge backend (data modules, HTTP/WebSocket APIs, CLI, discovery).

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Error handling and Realtime and WebSockets. The repository describes itself as: A bridge for your systems. The licence is Apache-2.0.

When your agent uses it

  • Reviewing Go code in the system-bridge backend (data modules
  • HTTP/WebSocket APIs

Example prompts

  • “/system-bridge-go-backend”

What it can do on your machine

Read from SKILL.md and the folder at commit 7a2d87e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go
    • mise

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

System Bridge Go Backend loads about 841 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 223 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~841

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from timmo001/system-bridge at commit 7a2d87e, republished under its Apache-2.0 licence (© timmo001). 223 words, ~841 tokens.

Download SKILL.mdSave it as .claude/skills/system-bridge-go-backend/SKILL.md (or your agent's skills folder).
name
system-bridge-go-backend
description
System Bridge Go backend conventions - error wrapping, graceful degradation for data modules, nil-pointer safety, context-aware Module.Update, structured slog logging, and errcheck-clean deferred cleanup. Use when writing or reviewing Go code in the system-bridge backend (data modules, HTTP/WebSocket APIs, CLI, discovery).

System Bridge Go Backend

Project-specific Go patterns for the system-bridge backend. General Go style an agent already knows is intentionally omitted.

Format and Lint

  • Always run go fmt ./... from the repo root after editing Go.
  • Before committing, run mise run lint:all (or golangci-lint run ./...).
  • CI runs golangci-lint. Watch errcheck: never leave unchecked error returns, especially deferred cleanup. All deferred os.RemoveAll() calls in tests must check the error.

File Naming

  • Go files lowercase.go, tests _test.go.
  • OS-specific files use build-tag suffixes: module_linux.go, module_windows.go, module_darwin.go.
  • Avoid generic names like utils.go; be specific.

Error Handling

go
// Wrap errors with context
if err != nil {
    return cpuData, fmt.Errorf("error getting CPU count: %v", err)
}

// Handle at the appropriate level; degrade gracefully only where safe
data, err := getData()
if err != nil {
    slog.Error("Failed to get data", "error", err)
    return defaultData, nil
}
  • Always check and handle errors; wrap with fmt.Errorf("context: %v", err).
  • Return errors up the stack; don't log-and-continue unless there is a clear reason.

Graceful Degradation

Data modules use best-effort strategies for optional metrics:

go
if temps, err := sensors.SensorsTemperatures(); err == nil {
    cpuData.Temperature = extractTemperature(temps)
}
if cpuData.Temperature == nil {
    if t := cm.ReadCPUTemperature(); t != nil {
        cpuData.Temperature = t
    }
}
  • Use for platform-specific features, optional enhancements, hardware-dependent data.
  • Do not use for critical functionality (auth, core API), data integrity (settings, state), or user-initiated actions.

Structured Logging

Use log/slog with structured fields, never string formatting:

go
slog.Info("Getting CPU data")
slog.Error("Failed to fetch data", "module", moduleName, "error", err)
// Avoid: slog.Info(fmt.Sprintf("Getting CPU data for %s", name))

Levels: Debug (troubleshooting detail), Info (state changes), Warn (handled anomalies), Error (affects functionality without crashing).

Nil-Pointer Safety

Optional values are pointer fields. Always nil-check before dereferencing, and give pointer targets a stable scope:

go
if cpuData.Temperature != nil {
    useTemperature(*cpuData.Temperature)
}
temp := 75.0
cpuData.Temperature = &temp

Context

Respect cancellation in Module.Update:

go
func (m Module) Update(ctx context.Context) (any, error) {
    data, err := cpu.CountsWithContext(ctx, true)
    if err != nil {
        return nil, err
    }
    select {
    case <-ctx.Done():
        return nil, ctx.Err()
    default:
    }
    // ...
}

Performance

  • Pre-allocate slices when size is known: make([]types.PerCPU, 0, len(frequencies)).
  • Use context timeouts for external calls; avoid frequent polling.
  • Pointers for large structs, values for small types.

© timmo001, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/system-bridge-go-backend of timmo001/system-bridge.

Open the folder on GitHubat commit 7a2d87e

Compare with similar skills

System Bridge Go Backend next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

System Bridge Go Backend compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
System Bridge Go Backend this skilltimmo001/system-bridge356—~841Automated safety check: PassApache-2.0
iOS Networkingdpearson2699/swift-ios-skills1.2k—~4.2kAutomated safety check: PassCustom licence
Classcadawv-informatik/classcad-ai122—~12kAutomated safety check: PassMIT
Lua Ecozhaojh329/lua-eco103—~1.7kAutomated safety check: PassMIT
Dev Rulesrust-dd/tako162—~810Automated safety check: PassMIT
Debug Logsadam-s/intercept189—~1.1kAutomated safety check: PassMIT

Similar skills

  • iOS Networking

    dpearson2699/swift-ios-skills

    Build, review, or improve networking code in iOS/macOS apps using URLSession with async/await, structured concurrency, and modern Swift patterns.

    1.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Classcad

    awv-informatik/classcad-ai

    Structured API reference for the ClassCAD headless parametric CAD engine (v1 JSON/WebSocket API).

    122 GitHub stars~12k tokensUpdated today
    Backend & APIsAuto-check passed
  • Lua Eco

    zhaojh329/lua-eco

    International lua-eco public API skill for writing, reviewing, explaining, and fixing Lua 5.4 code that runs on the eco runtime.

    103 GitHub stars~1.7k tokensUpdated 9 days ago
    Backend & APIsAuto-check passed
  • Dev Rules

    rust-dd/tako

    General coding-style rules to apply to every project. An agent skill from rust-dd/tako.

    162 GitHub stars~810 tokensUpdated 8 days ago
    Backend & APIsAuto-check passed
  • Debug Logs

    adam-s/intercept

    Iterative debugging with targeted logs. An agent skill from adam-s/intercept.

    189 GitHub stars~1.1k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Backend & APIsAuto-check passed

More from timmo001/system-bridge

All 13 skills in this repo
  • Writing Style

    timmo001/system-bridge

    Write commit messages, PR and issue text and comments, docs (README), code comments, and user-facing strings (notifications, UI labels, toasts, error messages) in the project owner's voice: concise…

    356 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • System Bridge Testing Workflow

    timmo001/system-bridge

    How to test System Bridge - Go table-driven tests and commands, web-client quality checks (lint/typecheck/format, no unit tests), the Chrome DevTools MCP interactive test loop for UI and WebSocket…

    356 GitHub stars~843 tokensUpdated today
    Auto-check passed
  • System Bridge Troubleshooting

    timmo001/system-bridge

    Known System Bridge build and runtime failures and their fixes, plus per-OS token/log/settings/data file locations.

    356 GitHub stars~637 tokensUpdated today
    Auto-check passed
  • Task Runners

    timmo001/system-bridge

    Run and write project tasks so checks, builds, tests and dev servers finish fast - run only what a change needs, in parallel, skipping work that is already up to date.

    356 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • System Bridge Docs Page Workflow

    timmo001/system-bridge

    Add or restructure a page in the System Bridge Astro + Starlight docs site under docs/ - create the content file, set frontmatter, and wire the sidebar.

    356 GitHub stars~376 tokensUpdated today
    Auto-check passed
  • Update the System Bridge marketing landing page in the Astro + Starlight docs site.

    356 GitHub stars~313 tokensUpdated today
    Auto-check passed

Questions about System Bridge Go Backend

What does System Bridge Go Backend do?

System Bridge Go backend conventions - error wrapping, graceful degradation for data modules, nil-pointer safety, context-aware Module.Update, structured slog logging, and errcheck-clean deferred…. System Bridge Go Backend is an agent skill from timmo001/system-bridge.Update, structured slog logging, and errcheck-clean deferred cleanup.

When should I use System Bridge Go Backend?

System Bridge Go Backend fits situations like: reviewing Go code in the system-bridge backend (data modules; HTTP/WebSocket APIs.

How do I install System Bridge Go Backend in Claude Code?

Run `npx skills add timmo001/system-bridge --skill system-bridge-go-backend -a claude-code`. Or copy the skill folder (.agents/skills/system-bridge-go-backend in timmo001/system-bridge) into .claude/skills/system-bridge-go-backend in your project. Claude Code loads it when a task matches its description.

How do I install System Bridge Go Backend in Codex?

Run `npx skills add timmo001/system-bridge --skill system-bridge-go-backend -a codex`. Or copy the skill folder (.agents/skills/system-bridge-go-backend in timmo001/system-bridge) into .agents/skills/system-bridge-go-backend in your project. Codex loads it when a task matches its description.

Can I use System Bridge Go Backend in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add timmo001/system-bridge --skill system-bridge-go-backend -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/system-bridge-go-backend, .gemini/skills/system-bridge-go-backend, .github/skills/system-bridge-go-backend and .opencode/skills/system-bridge-go-backend in your project.

What does System Bridge Go Backend need to run?

Going by SKILL.md and its folder, System Bridge Go Backend needs the command-line tools its instructions call (go and mise).

Does System Bridge Go Backend access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is System Bridge Go Backend safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does System Bridge Go Backend use?

System Bridge Go Backend is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does System Bridge Go Backend use?

About 841 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to System Bridge Go Backend?

Skills that share tags, products or a category with System Bridge Go Backend: iOS Networking (dpearson2699/swift-ios-skills, 1.2k stars), Classcad (awv-informatik/classcad-ai, 122 stars), Lua Eco (zhaojh329/lua-eco, 103 stars) and Dev Rules (rust-dd/tako, 162 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains System Bridge Go Backend?

timmo001 (a GitHub user) maintains it in timmo001/system-bridge, which has 356 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 9, 2026.

Source: timmo001/system-bridge on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.