Agent skill

Local Deployment

by bionic-gpt in bionic-gpt/bionic-gpt

Deploy one or more locally built Bionic services into the user's k3d cluster.

Apache-2.0Auto-check: notesDevOps & Cloud

Install Local Deployment

skills CLI
$ npx skills add bionic-gpt/bionic-gpt --skill local-deployment -a claude-code

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

GitHub CLI
$ gh skill install bionic-gpt/bionic-gpt local-deployment --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/bionic-gpt/bionic-gpt.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/local-deployment .claude/skills/local-deployment && 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
local-deployment
GitHub stars
2.4k
Token cost
~540 tokens
SKILL.md length
242 words
Files
4
Skills in repo
21
Repo updated
First seen
Licence
Apache-2.0

At a glance

Deploy one or more locally built Bionic services into the user's k3d cluster.

  • Ly when the user explicitly asks for a local
  • Runs Shell scripts from its folder; calls bash, kubectl and apt-get
  • Kubernetes deployment

What it does

Local Deployment is an agent skill from bionic-gpt/bionic-gpt. Deploy one or more locally built Bionic services into the user's k3d cluster. Trigger only when the user explicitly asks for a local, k3d, or Kubernetes deployment.

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `deploy-to-k3d-locally.sh`).

It sits in DevOps & Cloud, covering Deployment and Container orchestration. It works with Kubernetes. The repository describes itself as: Bionic is sovereign Agentic AI for the enterprise — Runs on-premise and can securely work with your sensitive data and systems. The licence is Apache-2.0.

When your agent uses it

  • Ly when the user explicitly asks for a local
  • Kubernetes deployment

Example prompts

  • “/local-deployment”

Requirements

  • A Bash shell
  • Docker

What it can do on your machine

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

    Ships script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • kubectl
    • apt-get

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

  • Network

    No URLs in SKILL.md. Its commands use kubectl, which can reach the network depending on how they are called.

    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

Local Deployment loads about 540 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 242 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:43
    opment. It may install `iproute2` using `sudo apt-get`; review its effects

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 bionic-gpt/bionic-gpt at commit c155c00, republished under its Apache-2.0 licence (© bionic-gpt). 242 words, ~540 tokens.

Download SKILL.mdSave it as .claude/skills/local-deployment/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
local-deployment
description
Deploy one or more locally built Bionic services into the user's k3d cluster. Trigger only when the user explicitly asks for a local, k3d, or Kubernetes deployment.

Local Deployment

Use this skill for an explicit request to deploy Bionic services locally or to the k3d development cluster.

Run the bundled script from the repository root:

bash
bash .agents/skills/local-deployment/deploy-to-k3d-locally.sh [service ...]

Service names match spec.services in the StackApp. Pass several names to deploy them together, for example web cli-gateway; omitting names deploys web. The script builds each local Cargo binary, imports its image into k3d-bionic, patches that service, and waits for its rollout. Web assets and the CLI gateway's Typst runtime are packaged automatically.

Web deployments enable Bionic debug logging through LOG_LEVEL and targeted Rig request and stream tracing through RIG_LOG.

Prerequisites:

  • Docker, k3d and kubectl are installed and available as explicit commands.
  • The k3d-bionic cluster exists.
  • kubectl is using the k3d-k3d-bionic context.
  • The bionic-gpt namespace and StackApp are available.

Before deployment, ensure the default kubeconfig has a reachable API server address for the current host. If the context is missing or the API server is unreachable, run the repository's local kubeconfig setup script:

bash
bash .agents/skills/k3d-environment/get-config.sh

This writes/merges the k3d-bionic kubeconfig, replaces loopback/wildcard addresses with the host gateway, and disables TLS verification for local development. It may install iproute2 using sudo apt-get; review its effects before running it on a new machine. Then run the deployment script above.

Inspect web traces after deployment with:

bash
kubectl logs deployment/bionic-gpt --namespace bionic-gpt --tail=200

Look for agent_runtime debug events, outgoing requests under rig::completions, and incoming SSE frames under rig::streaming. These settings are applied by the local deployment script only and are not added to production StackApp manifests.

© bionic-gpt, 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

SKILL.md and 3 other files in .agents/skills/local-deployment of bionic-gpt/bionic-gpt.

  • SKILL.md
  • Dockerfile.service
  • Dockerfile.web
  • deploy-to-k3d-locally.sh

Open the folder on GitHubat commit c155c00

Compare with similar skills

Local Deployment 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.

Local Deployment compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Deployment this skillbionic-gpt/bionic-gpt2.4k—~540Automated safety check: NotesApache-2.0
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
KubeSphere ServiceMesh Managerkubesphere/kubesphere17k—~2.4kAutomated safety check: PassCustom licence
LangBot Deployment Guidelangbot-app/LangBot18k—~1.2kAutomated safety check: NotesApache-2.0
Openbkn Deployopenbkn-ai/bkn-foundry629—~1.9kAutomated safety check: NotesCustom licence
KubeShark for KubernetesLukasNiessen/kubernetes-skill444—~1.2kAutomated safety check: PassMIT

Similar skills

  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated 7 days ago
    DevOps & CloudAuto-check: notes
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Openbkn Deploy

    openbkn-ai/bkn-foundry

    Deploy or upgrade OpenBKN on a customer-authorized Linux server through the repository's deploy scripts, with preflight checks, explicit confirmation, secret handling, and post-deployment…

    629 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • KubeShark for Kubernetes

    LukasNiessen/kubernetes-skill

    Keeps Kubernetes manifests, Helm charts and policies grounded by diagnosing six failure modes, such as insecure defaults and API drift, and loading only matching references.

    444 GitHub stars~1.2k tokensUpdated 24 days ago
    DevOps & CloudAuto-check passed
  • Debug Openshell Cluster

    NVIDIA/OpenShell

    Official

    Debug why an OpenShell gateway deployment is unhealthy, unreachable, or unable to create sandboxes.

    15k GitHub stars~19k tokensUpdated today
    DevOps & CloudAuto-check: notes

More from bionic-gpt/bionic-gpt

All 21 skills in this repo
  • Static Sites

    bionic-gpt/bionic-gpt

    Create or modify Bionic's generated marketing site, documentation, blog, course pages, and static assets.

    2.4k GitHub stars~920 tokensUpdated today
    Auto-check passed
  • Automationbench Eval

    bionic-gpt/bionic-gpt

    Load the repository's AutomationBench OpenAPI catalogue and run evaluations against the local simulator.

    2.4k GitHub stars~619 tokensUpdated today
    Auto-check passed
  • Ron Auth

    bionic-gpt/bionic-gpt

    Implement identity and authorization boundaries in Rust on Nails applications.

    2.4k GitHub stars~667 tokensUpdated today
    Auto-check passed
  • Ron Web Pages

    bionic-gpt/bionic-gpt

    Build server-rendered Dioxus pages using opinionated Rust on Nails patterns.

    2.4k GitHub stars~616 tokensUpdated today
    Auto-check passed
  • Document Generation

    bionic-gpt/bionic-gpt

    Create polished printable documents and PDFs, including forms, checklists, reports, briefs, comparisons, worksheets, task lists, and other operational documents.

    2.4k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Office Tools

    bionic-gpt/bionic-gpt

    Regenerate the built-in Office OpenAPI specs from a selected Archipelago ref.

    2.4k GitHub stars~352 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Local Deployment

What does Local Deployment do?

Deploy one or more locally built Bionic services into the user's k3d cluster. Local Deployment is an agent skill from bionic-gpt/bionic-gpt. Deploy one or more locally built Bionic services into the user's k3d cluster.

When should I use Local Deployment?

Local Deployment fits situations like: ly when the user explicitly asks for a local; Kubernetes deployment.

How do I install Local Deployment in Claude Code?

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

How do I install Local Deployment in Codex?

Run `npx skills add bionic-gpt/bionic-gpt --skill local-deployment -a codex`. Or copy the skill folder (.agents/skills/local-deployment in bionic-gpt/bionic-gpt) into .agents/skills/local-deployment in your project. Codex loads it when a task matches its description.

Can I use Local Deployment 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 bionic-gpt/bionic-gpt --skill local-deployment -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-deployment, .gemini/skills/local-deployment, .github/skills/local-deployment and .opencode/skills/local-deployment in your project.

What does Local Deployment need to run?

Going by SKILL.md and its folder, Local Deployment needs a shell for the scripts in its folder and the command-line tools its instructions call (bash, kubectl and apt-get). Our summary lists: A Bash shell; Docker.

Does Local Deployment 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 Local Deployment safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Local Deployment use?

Local Deployment 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 Local Deployment use?

About 540 tokens (SKILL.md is roughly 2.2k 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 Local Deployment?

Skills that share tags, products or a category with Local Deployment: Kubeshark Installer (kubeshark/kubeshark, 12k stars), KubeSphere ServiceMesh Manager (kubesphere/kubesphere, 17k stars), LangBot Deployment Guide (langbot-app/LangBot, 18k stars) and Openbkn Deploy (openbkn-ai/bkn-foundry, 629 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Deployment?

bionic-gpt (a GitHub organization) maintains it in bionic-gpt/bionic-gpt, which has 2,383 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 7, 2026.

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