New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

System Bridge Troubleshooting

by timmo001 in timmo001/system-bridge

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

Apache-2.0Auto-check passed

Install System Bridge Troubleshooting

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

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

GitHub CLI
$ gh skill install timmo001/system-bridge system-bridge-troubleshooting --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-troubleshooting .claude/skills/system-bridge-troubleshooting && 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-troubleshooting
GitHub stars
356
Token cost
~637 tokens
SKILL.md length
158 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • A system-bridge build fails
  • SKILL.md covers Build, Runtime, OS-Specific and File Locations
  • Calls mise, go and bun
  • The web-client embed is stale

What it does

System Bridge Troubleshooting is an agent skill from timmo001/system-bridge. Known System Bridge build and runtime failures and their fixes, plus per-OS token/log/settings/data file locations. Use when a system-bridge build fails, the web-client embed is stale, ports conflict, token auth fails, cross-compilation breaks, or you need the on-disk data/log paths.

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

It works with TypeScript. The repository describes itself as: A bridge for your systems. The licence is Apache-2.0.

When your agent uses it

  • A system-bridge build fails
  • The web-client embed is stale
  • Token auth fails
  • Cross-compilation breaks

Example prompts

  • “/system-bridge-troubleshooting”

What it can do on your machine

Read from SKILL.md and the folder at commit 504c45d. 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:

    • mise
    • go
    • bun

    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 Troubleshooting loads about 637 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 158 words of instructions outside code blocks.

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

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 504c45d, republished under its Apache-2.0 licence (© timmo001). 158 words, ~637 tokens.

Download SKILL.mdSave it as .claude/skills/system-bridge-troubleshooting/SKILL.md (or your agent's skills folder).
name
system-bridge-troubleshooting
description
Known System Bridge build and runtime failures and their fixes, plus per-OS token/log/settings/data file locations. Use when a system-bridge build fails, the web-client embed is stale, ports conflict, token auth fails, cross-compilation breaks, or you need the on-disk data/log paths.

System Bridge Troubleshooting

Build

Missing web-client/dist/index.html:

bash
mise run clean:web-client
mise run build:web-client

Go embed stale after web-client changes: the //go:embed directive bundles files at compile time, so rebuild the binary:

bash
mise run build:all   # rebuilds web client AND Go binary

Module / dependency issues:

bash
go clean -modcache
go mod download
go mod verify
go mod tidy

TypeScript errors after a dependency update:

bash
cd web-client
rm -rf node_modules bun.lock
bun install
bun run build

Runtime

Port in use (default 9170):

bash
lsof -i :9170                  # Linux/macOS
netstat -ano | findstr :9170   # Windows
export SYSTEM_BRIDGE_PORT=9171

Token / auth failures: regenerate with system-bridge client token. Token path is under the per-OS data dir (see below).

Cross-compilation:

bash
GOOS=linux   GOARCH=amd64 go build -o system-bridge-linux
GOOS=windows GOARCH=amd64 go build -o system-bridge.exe

Some modules may not cross-build due to OS-specific dependencies.

OS-Specific

  • Linux: install required system libraries (see README.md); systray may need libayatana-appindicator; some modules need root.
  • Windows: use PowerShell; quote paths with spaces; some features need Administrator. Debug multiple instances with mise run processes:list / mise run processes:stop, and mise run build:console / mise run run:console for terminal logs.
  • macOS: grant monitoring permissions in System Settings > Privacy & Security; some features are experimental; Apple Silicon may differ from Intel.

File Locations

App data (settings, token):
  Linux:   ~/.local/share/system-bridge/v5/
  Windows: %LOCALAPPDATA%\system-bridge\v5\
  macOS:   ~/Library/Application Support/system-bridge/v5/

Token:      <app data>/token
Logs:
  Linux:   ~/.local/state/system-bridge/YYYY-MM-DD.log
  Windows: %LOCALAPPDATA%\system-bridge\logs\YYYY-MM-DD.log
  macOS:   ~/Library/Logs/system-bridge/YYYY-MM-DD.log

Legacy system-bridge.log files in the v5 app-data dir are migrated on next startup; daily logs older than 7 days are removed on startup.

© 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-troubleshooting of timmo001/system-bridge.

Open the folder on GitHubat commit 504c45d

Compare with similar skills

System Bridge Troubleshooting 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 Troubleshooting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
System Bridge Troubleshooting this skilltimmo001/system-bridge356—~637Automated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 64 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed

  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed

  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • Nx Import

    nrwl/nx

    Import, merge, or combine repositories into an Nx workspace using nx import.

    29k GitHub starsUsed in 6 repos~3.5k tokens
    DevelopmentAuto-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 yesterday
    Auto-check passed

  • System Bridge Go Backend

    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…

    356 GitHub stars~841 tokensUpdated yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

  • System Bridge Landing Content Updates

    timmo001/system-bridge

    Update the System Bridge marketing landing page in the Astro + Starlight docs site.

    356 GitHub stars~313 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about System Bridge Troubleshooting

What does System Bridge Troubleshooting do?

Known System Bridge build and runtime failures and their fixes, plus per-OS token/log/settings/data file locations. System Bridge Troubleshooting is an agent skill from timmo001/system-bridge. Known System Bridge build and runtime failures and their fixes, plus per-OS token/log/settings/data file locations.

When should I use System Bridge Troubleshooting?

System Bridge Troubleshooting fits situations like: A system-bridge build fails; the web-client embed is stale; token auth fails; cross-compilation breaks.

How do I install System Bridge Troubleshooting in Claude Code?

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

How do I install System Bridge Troubleshooting in Codex?

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

Can I use System Bridge Troubleshooting 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-troubleshooting -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-troubleshooting, .gemini/skills/system-bridge-troubleshooting, .github/skills/system-bridge-troubleshooting and .opencode/skills/system-bridge-troubleshooting in your project.

What does System Bridge Troubleshooting need to run?

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

Does System Bridge Troubleshooting 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 Troubleshooting 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 Troubleshooting use?

System Bridge Troubleshooting 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 Troubleshooting use?

About 637 tokens (SKILL.md is roughly 2.5k 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 Troubleshooting?

Skills that share tags, products or a category with System Bridge Troubleshooting: MCP Server Builder (anthropics/skills, 180k stars), Web Artifacts Builder (anthropics/skills, 180k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains System Bridge Troubleshooting?

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 8, 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.