bex-debug

bex-debug is a skill for Claude Code, Codex from bex-co/bex. It costs 58 tokens per session (2,100 once invoked), scanned A, original, Apache-2.0.

A troubleshooting helper for failed or unhealthy bex deployments and services. It examines logs, metrics, and database state to help find causes such as missing environment variables, port problems, memory limits, or failed health checks.

In plain words
What is it for?
Investigate failed releases, startup crashes, timeouts, slow responses, application errors, and database connection problems on bex.
Why use it?
It reduces the need to guess why a release failed or a service keeps restarting. The workflow also checks the relevant deployment and configuration details before suggesting changes.

Skill for Claude CodeCodex

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

Good fit Investigate failed releases, startup crashes, timeouts, slow responses, application errors, and database connection problems on bex.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/bex-co/bex/bex-debug
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 bex-co/bex --skill bex-debug
Clone the repo
git clone --depth 1 https://github.com/bex-co/bex

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 bex-debug

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

Your own site · 80×15
<a href="https://agentmods.dev/skills/bex-co/bex/bex-debug"><img src="https://agentmods.dev/badge/skills/bex-co/bex/bex-debug.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 58 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,100 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. 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.00058 $0.02100
Opus 5.5 $0.00023 $0.00840
Sonnet 5.5 $0.00012 $0.00420
Haiku 4.5 $0.00006 $0.00210

Measured yesterday against content hash 8a3988568729, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

bex-debug scanned grade A with 1 finding 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 yesterday.

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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

1. Retrieve the linked Markdown document directly with an available URL-fetching tool or HTTP client, such as `curl`. Do not substitute web-search summaries for the document.
lego/cli/internal/skills/pack/skills/bex-debug/SKILL.md · 252 lines

How it starts

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

Debug bex Deployments

Analyze deployment failures using logs, metrics, and database queries. Identify root causes and apply fixes.

When to Use This Skill

Activate this skill when:

  • Deployment fails on bex
  • Service won't start or keeps crashing
  • User mentions errors, logs, or debugging
  • Health checks are timing out
  • Application errors in production
  • Performance issues (slow responses)
  • Database connection problems

bex Access

Before reading logs, metrics, or database state, follow references/bex-access.md to establish access and verify the intended workspace. Prefer MCP when available; the CLI can provide logs and deploy status, while metrics and structured database queries require MCP.


Debugging Workflow

When the failure involves configuration or secrets, read references/environment-variables.md before inspecting or changing service variables. When the failure involves deploy state, rollout, health checks, restart, rollback, or shutdown, read references/deployments.md before diagnosing it.

Step 1: Identify Failed Service

list_services()

If MCP isn't configured, ask whether to set it up (preferred) or continue with CLI. Then proceed.

Look for services with failed status. Get details:

get_service(serviceId: "<id>")

Step 2: Retrieve Logs

Build/Deploy Logs (most failures):

list_logs(resource: ["<service-id>"], type: ["build"], limit: 200)

Runtime Error Logs:

list_logs(resource: ["<service-id>"], level: ["error"], limit: 100)

Search for Specific Errors:

list_logs(resource: ["<service-id>"], text: ["KeyError", "ECONNREFUSED"], limit: 50)

HTTP Error Logs:

list_logs(resource: ["<service-id>"], statusCode: ["500", "502", "503"], limit: 50)

Step 3: Analyze Error Patterns

Match log errors against known patterns:

Error Log Pattern Common Fix
MISSING_ENV_VAR KeyError, not defined Add to render.yaml or update_environment_variables
PORT_BINDING EADDRINUSE Use 0.0.0.0:$PORT
MISSING_DEPENDENCY Cannot find module Add to package.json/requirements.txt
DATABASE_CONNECTION ECONNREFUSED :5432 Check DATABASE_URL, DB status
HEALTH_CHECK Health check timeout Add /health endpoint, check port binding
OUT_OF_MEMORY heap out of memory, exit 137 Optimize memory or upgrade plan
BUILD_FAILURE Command failed Fix build command or dependencies

Read the full file on GitHub · 252 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. yesterday First seen · 252 lines · 58 tokens per session scan A 8a3988568729

Subscribe to this mod's changes

bex-debug is a skill published in the GitHub repository bex-co/bex (577 stars, last pushed today), licensed Apache-2.0. It adds 58 tokens to every session and 2,100 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-29.

Related

Other skills, from other repositories

network-rca

Kubernetes network root cause analysis skill powered by Kubeshark MCP. Use this skill whenever the user wants to investigate past incidents, perform retrospective traffic analysis, take or manage traffic snapshots, extract PCAPs, dissect L7 API calls from historical captures, compare traffic patterns over time, detect…

kubeshark/kubeshark · 163 tokens

troubleshoot-sandbox

Troubleshoot OpenSandbox issues by running diagnostics (logs, inspect, events, summary) via CLI or HTTP API to diagnose sandbox failures like OOM, crash, image pull errors, network problems, etc.

opensandbox-group/OpenSandbox · 48 tokens

mirrord-up

Helps users run multiple concurrent mirrord sessions from a single mirrord-up.yaml (compose-style multi-service local debugging). Use when the user mentions mirrord up, mirrord-up.yaml, mirrord up init, debugging several related microservices together, or managing multiple mirrord sessions' lifecycle in one command.

metalbear-co/mirrord · 73 tokens

install

Kubeshark installation and deployment skill. Use this skill whenever the user wants to install Kubeshark, deploy Kubeshark to a Kubernetes cluster, set up Kubeshark, configure Kubeshark helm values, generate a Kubeshark config file, customize Kubeshark deployment, troubleshoot Kubeshark installation, upgrade…

kubeshark/kubeshark · 257 tokens

k8s-incident

Respond to Kubernetes incidents with runbooks and diagnostics. Use for outages, pod failures, node issues, network problems, and emergency response.

rohitg00/kubectl-mcp-server · 33 tokens

k8s-cilium

Cilium and Hubble network observability for Kubernetes. Use when managing network policies, observing traffic flows, or troubleshooting connectivity with eBPF-based networking.

rohitg00/kubectl-mcp-server · 37 tokens