Agent skill

System Bridge Release

by timmo001 in timmo001/system-bridge

Release System Bridge and its Python and TypeScript connectors.

Apache-2.0Auto-check passedDevelopment

Install System Bridge Release

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

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

GitHub CLI
$ gh skill install timmo001/system-bridge system-bridge-release --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-release .claude/skills/system-bridge-release && 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-release
GitHub stars
357
Token cost
~1.6k tokens
SKILL.md length
616 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

Release System Bridge and its Python and TypeScript connectors.

  • Publishing a GitHub release
  • SKILL.md covers Versions, Release, What a stable release publishes and Sense checks, plus 2 more sections
  • Calls gh, curl and jq; reaches pypi.org and jsr.io; needs AUR_SSH_PRIVATE_KEY and ARCH_REPO_DISPATCH_TOKEN
  • Choosing the next version

What it does

System Bridge Release is an agent skill from timmo001/system-bridge. Release System Bridge and its Python and TypeScript connectors. Use when preparing or publishing a GitHub release, choosing the next version, checking what a release published (release assets, PyPI, npm, JSR, the Arch package repository and AUR), or debugging the release jobs in build-and-package-application.yml.

Its SKILL.md is about 1.6k 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 Development. It works with GitHub, Python, TypeScript and npm. The repository describes itself as: A bridge for your systems. The licence is Apache-2.0.

When your agent uses it

  • Publishing a GitHub release
  • Choosing the next version
  • Checking what a release published (release assets
  • The Arch package repository and AUR)

Example prompts

  • “/system-bridge-release”

Requirements

  • Python 3
  • A credential in AUR_SSH_PRIVATE_KEY
  • A credential in ARCH_REPO_DISPATCH_TOKEN

What it can do on your machine

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

    • gh
    • curl
    • jq
    • npm
    • git

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • pypi.org
    • jsr.io
    • aur.archlinux.org

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AUR_SSH_PRIVATE_KEY
    • ARCH_REPO_DISPATCH_TOKEN

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

Context cost

System Bridge Release loads about 1.6k tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 616 words of instructions outside code blocks.

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

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 94a7adc, republished under its Apache-2.0 licence (© timmo001). 616 words, ~1,645 tokens.

Download SKILL.mdSave it as .claude/skills/system-bridge-release/SKILL.md (or your agent's skills folder).
name
system-bridge-release
description
Release System Bridge and its Python and TypeScript connectors. Use when preparing or publishing a GitHub release, choosing the next version, checking what a release published (release assets, PyPI, npm, JSR, the Arch package repository and AUR), or debugging the release jobs in build-and-package-application.yml.

Releasing System Bridge

One version covers the application, the Python connector (systembridgeconnector) and the TypeScript connector (@timmo001/effect-system-bridge). Publishing a non-prerelease GitHub release runs .github/workflows/build-and-package-application.yml, which builds and publishes everything at once.

Releasing is a public, irreversible publish. Create a tag or release only when the user asks, and use their chosen version.

Versions

  • Tags are the exact version with no v prefix, as in 5.11.1.
  • Nothing needs bumping before a release. The Go binary gets its version from the tag at build time (.github/scripts/bash/get-version.sh), and CI writes the tag into connector/python/pyproject.toml and the TypeScript connector's package.json and jsr.json, whose committed versions stay 0.0.0.
  • The Omarchy plugin (omarchy-plugin/manifest.json) and the docs site are versioned and deployed separately, so a release doesn't change them.
  • Patch for fixes and quiet changes, minor for new features or modules. Large moves of existing code, such as importing the connector, are still patch.

Release

Check dev has passed CI first, especially Build and package application, so the release builds the same commit that passed.

Notes

Write the release notes by hand rather than using GitHub's generated list. Read git log <previous version>..<dev commit> and the previous releases (gh release view <version> --json body -q .body), and follow the writing-style skill. Match their shape:

  • One or two sentences on what the release does. Say "No changes to the application" when that's true.
  • ## sections by area (a module such as Discord, a platform such as Linux, CLI, Connector, Docs), then Moved for anything that breaks automations, Dependencies and Maintenance.
  • Bullets that start with a verb and name real identifiers in backticks. Link PRs as (#1234) and the docs pages for new features.
  • Credit first-time contributors under New contributors.
  • End with **Full Changelog**: https://github.com/timmo001/system-bridge/compare/<previous version>...<version>.
Publish

Create the release at the checked commit:

bash
gh release create <version> --target <dev commit sha> --title <version> --notes-file notes.md

When the maintainer's dot git-releases helper is available, use it instead: it compares dev with the last stable release, suggests an impact, and tags and publishes from a reviewed snapshot. Pass the same notes file.

bash
dot git-releases --repo timmo001/system-bridge --refresh
dot git-releases review --repo timmo001/system-bridge --snapshot <id> --finding <id> --impact patch   # override a suggestion
dot git-releases publish --repo timmo001/system-bridge --snapshot <id> --notes-file notes.md --notes-mode replace   # preview the plan
dot git-releases publish --repo timmo001/system-bridge --snapshot <id> --notes-file notes.md --notes-mode replace --confirm <plan>

Its suggestion counts large added source as minor. Review those findings down to patch when the code isn't new behaviour.

To fix notes after publishing, gh release edit <version> --notes-file notes.md.

Show full SKILL.md (256 more words)Show less

What a stable release publishes

All of this comes from the release jobs in build-and-package-application.yml:

  • Release assets: the deb, rpm, Flatpak and Windows installer, with a sigstore bundle (update-release)
  • Arch: the system-bridge package (epoch 2:), built and attached to the release with its own sigstore bundle, then dispatched to timmo001/arch-repo for the signed timmo pacman repository (build-arch-package-stable, attach-arch-package-stable)
  • AUR: system-bridge (update-aur-stable)
  • PyPI: systembridgeconnector, built from connector/python with the tag as its version (build-connector-python, publish-connector-python)
  • npm and JSR: @timmo001/effect-system-bridge, from connector/typescript with the tag as its version, through the shared timmo001/workflows publish workflows (publish-connector-typescript-npm, publish-connector-typescript-jsr)

A prerelease only attaches assets. system-bridge-git publishes from pushes to dev, not from releases.

Sense checks

These jobs have passed on every recent release, so don't wait for them each time. Check they've started, then look back later or when something seems off:

bash
gh run list -R timmo001/system-bridge --event release --limit 1    # the release run
gh release view <version> -R timmo001/system-bridge --json assets -q '.assets[].name'
curl -s https://pypi.org/pypi/systembridgeconnector/json | jq -r .info.version
npm view @timmo001/effect-system-bridge version
curl -s https://jsr.io/@timmo001/effect-system-bridge/meta.json | jq -r .latest
gh run list -R timmo001/arch-repo --limit 3                         # "Publish system-bridge" dispatch
curl -s https://aur.archlinux.org/rpc/v5/info/system-bridge | jq -r '.results[0].Version'

A finished release has seven assets: system-bridge-2.<version>-1-x86_64.pkg.tar.zst, system-bridge-<version>-1.x86_64.rpm, system-bridge_<version>_amd64.deb, system-bridge-<version>.flatpak, system-bridge-<version>-setup.exe, system-bridge-<version>.sigstore.json and system-bridge-<version>-arch.sigstore.json. PyPI, npm, JSR and the AUR show the new version once their jobs finish.

Setup

These live outside the repository and only need redoing when they break or are rotated:

  • AUR_SSH_PRIVATE_KEY and ARCH_REPO_DISPATCH_TOKEN repository secrets. The arch-repo-dispatch-secret skill rotates the dispatch token.
  • A PyPI trusted publisher on systembridgeconnector for timmo001/system-bridge, workflow build-and-package-application.yml, no environment.
  • An npm trusted publisher on @timmo001/effect-system-bridge for timmo001/system-bridge, workflow build-and-package-application.yml, and the JSR package linked to timmo001/system-bridge. The npm-jsr-first-publish skill sets both up before the first release.

After a release

Install only published packages, from the signed timmo pacman repository, never a local build. Check with pacman -Qo "$(command -v system-bridge)".

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

Open the folder on GitHubat commit 94a7adc

Compare with similar skills

System Bridge Release 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 Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
System Bridge Release this skilltimmo001/system-bridge357—~1.6kAutomated safety check: PassApache-2.0
Release Roundethereumjs/ethereumjs-monorepo2.8k—~2kAutomated safety check: PassNone
Linea Dependency MaintenanceConsensys-Incorporated/linea-attestation-registry1771 repos~3.7kAutomated safety check: WarnMIT
Releaseseasonedcc/remix-forms514—~1.3kAutomated safety check: PassMIT
Upgrade Starter Kitworkadventure/map-starter-kit157—~1.3kAutomated safety check: NotesCustom licence
Release New Versionkcsujeet/ilamy-calendar351—~5.8kAutomated safety check: PassMIT

Similar skills

  • Release Round

    ethereumjs/ethereumjs-monorepo

    Runs a coordinated EthereumJS npm release round in six human-gated phases — intent and readiness, CHANGELOG, version bump, publish (human executes), post-publish verification, and announcements.

    2.8k GitHub stars~2k tokensUpdated 22 days ago
    DevelopmentAuto-check passed
  • Linea Dependency Maintenance

    Consensys-Incorporated/linea-attestation-registry

    Safely plan and execute dependency maintenance for JavaScript/TypeScript (npm, pnpm) and GitHub Actions, including npm lockfiles, pnpm workspaces, catalogs, overrides, SHA-pinned action versions…

    177 GitHub starsUsed in 1 repo~3.7k tokens
    DevelopmentAuto-check: warnings
  • Release

    seasonedcc/remix-forms

    Release a new version of the remix-forms npm package. An agent skill from seasonedcc/remix-forms.

    514 GitHub stars~1.3k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • Upgrade Starter Kit

    workadventure/map-starter-kit

    Upgrade a WorkAdventure map repository to the latest version of the map-starter-kit (github.com/workadventure/map-starter-kit) - refreshes package.json dependencies, vite/tsconfig/build config, CI…

    157 GitHub stars~1.3k tokensUpdated 7 days ago
    DevelopmentAuto-check: notes
  • Release New Version

    kcsujeet/ilamy-calendar

    Cut a new release of @ilamy/calendar — analyze commits since the last tag, suggest a semver bump, draft a CHANGELOG entry in the project's existing style, run the CI gate, commit, tag, push to…

    351 GitHub stars~5.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release TS SDK

    aptos-labs/aptos-ts-sdk

    A skill your agent uses when cutting a release of @aptos-labs/ts-sdk or @aptos-labs/confidential-asset.

    116 GitHub stars~864 tokensUpdated today
    DevelopmentAuto-check passed

More from timmo001/system-bridge

All 18 skills in this repo
  • Effect Service Design

    timmo001/system-bridge

    Design Effect services. An agent skill from timmo001/system-bridge.

    357 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • 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…

    357 GitHub stars~3.3k tokensUpdated today
    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…

    357 GitHub stars~841 tokensUpdated today
    Auto-check passed
  • Effect

    timmo001/system-bridge

    Opinionated guide for building production TypeScript applications with Effect v4.

    357 GitHub starsUsed in 2 repos~1.9k tokens
    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…

    357 GitHub stars~844 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.

    357 GitHub stars~637 tokensUpdated today
    Auto-check passed

Categories

Questions about System Bridge Release

What does System Bridge Release do?

Release System Bridge and its Python and TypeScript connectors. System Bridge Release is an agent skill from timmo001/system-bridge. Release System Bridge and its Python and TypeScript connectors.

When should I use System Bridge Release?

System Bridge Release fits situations like: publishing a GitHub release; choosing the next version; checking what a release published (release assets; the Arch package repository and AUR).

How do I install System Bridge Release in Claude Code?

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

How do I install System Bridge Release in Codex?

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

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

What does System Bridge Release need to run?

Going by SKILL.md and its folder, System Bridge Release needs the command-line tools its instructions call (gh, curl, jq, npm and git) and credentials named AUR_SSH_PRIVATE_KEY and ARCH_REPO_DISPATCH_TOKEN. Our summary lists: Python 3; A credential in AUR_SSH_PRIVATE_KEY; A credential in ARCH_REPO_DISPATCH_TOKEN.

Does System Bridge Release access the network?

SKILL.md names 3 domains. In commands or code: pypi.org, jsr.io and aur.archlinux.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

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

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

About 1.6k tokens (SKILL.md is roughly 6.6k 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 Release?

Skills that share tags, products or a category with System Bridge Release: Release Round (ethereumjs/ethereumjs-monorepo, 2.8k stars), Linea Dependency Maintenance (Consensys-Incorporated/linea-attestation-registry, 177 stars), Release (seasonedcc/remix-forms, 514 stars) and Upgrade Starter Kit (workadventure/map-starter-kit, 157 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains System Bridge Release?

timmo001 (a GitHub user) maintains it in timmo001/system-bridge, which has 357 GitHub stars. The repository holds 18 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.