Agent skill

Runtime Debug

by OutThisLife in OutThisLife/brooklyn-skills

Debug broken runtime/environments by checking logs and observability first, then code.

MITAuto-check passedDevOps & Cloud

Install Runtime Debug

skills CLI
$ npx skills add OutThisLife/brooklyn-skills --skill runtime-debug -a claude-code

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

GitHub CLI
$ gh skill install OutThisLife/brooklyn-skills runtime-debug --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/OutThisLife/brooklyn-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/runtime-debug .claude/skills/runtime-debug && 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
runtime-debug
GitHub stars
199
Token cost
~777 tokens
SKILL.md length
400 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Debug broken runtime/environments by checking logs and observability first, then code.

  • Works in 5 steps: Reproduce and capture the real failure… → Check observability first: logs, traces,… → Locate the failing service/line from the… → …
  • Ephemeral/CI environment fails at runtime rather than a local code bug
  • SKILL.md covers Steps, MR local preview, Research preview latency and pnpm deployment installs, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Runtime Debug is an agent skill from OutThisLife/brooklyn-skills. Debug broken runtime/environments by checking logs and observability first, then code. Use when a URL, deploy, or ephemeral/CI environment fails at runtime rather than a local code bug.

Its SKILL.md is about 780 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 DevOps & Cloud, covering Observability. It works with Docker. The repository describes itself as: Skills that drive best-in-class engineering. The licence is MIT.

When your agent uses it

  • Ephemeral/CI environment fails at runtime rather than a local code bug
  • Tasks that involve Observability

Example prompts

  • “/runtime-debug”

Requirements

  • Docker

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Reproduce and capture the real failure (status, error, request id, time).
  2. Check observability first: logs, traces, metrics. Use an observability MCP
  3. Locate the failing service/line from the evidence, not a guess.
  4. Fix the real cause. Don't add logging-only "fixes" and call it done.
  5. For intentional lab/ephemeral config (test secrets, fail-open), don't raise

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Runtime Debug loads about 777 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 400 words of instructions outside code blocks.

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

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 OutThisLife/brooklyn-skills at commit 8a97904, republished under its MIT licence (© OutThisLife). 400 words, ~777 tokens.

Download SKILL.mdSave it as .claude/skills/runtime-debug/SKILL.md (or your agent's skills folder).
name
runtime-debug
description
Debug broken runtime/environments by checking logs and observability first, then code. Use when a URL, deploy, or ephemeral/CI environment fails at runtime rather than a local code bug.

Runtime Debug

When something breaks at runtime (a URL 500s, a deploy is down, an ephemeral env misbehaves), look at what actually happened before editing code.

Steps

  1. Reproduce and capture the real failure (status, error, request id, time).
  2. Check observability first: logs, traces, metrics. Use an observability MCP (e.g. Datadog) if one is available/connected; otherwise fall back to the platform's log stream (CI job, container, Jenkins, cloud logs).
  3. Locate the failing service/line from the evidence, not a guess.
  4. Fix the real cause. Don't add logging-only "fixes" and call it done.
  5. For intentional lab/ephemeral config (test secrets, fail-open), don't raise false alarms — leave required env in place.

MR local preview

  • For a requested local link, start the actual worktree app against existing Docker datastores; do not substitute a screenshot gallery. Check Docker Desktop and existing containers first, then use the worktree's Node 18.20.4 and explicit NODE_ENV=local / NODE_PATH. Verify /200 and the requested page separately: a healthy server can still return 404 when Mongo has no CMS content.
  • Inspect local CMS collection counts before attempting a restore. An empty Atlas Local container needs sanitized seed data; inspect cached archives and download size before starting a large refresh, especially on constrained connections. Never reset or reseed existing data just to start the server.
Show full SKILL.md (185 more words)Show less

Research preview latency

  • Separate middleware TTFB from image/render timing before changing public pages. In the portal app, a local preview with unconfigured Upstash Redis can spend seconds retrying rate-limit calls even when the page itself is static.
  • Reuse the existing Docker Redis and serverless-redis-http services and their mapped ports. Verify the HTTP pipeline and then the page's rate-limit headers after reconnecting the preview; never bypass production limiting to make a local timing look fast.
  • Use headed Chrome when Vercel's preview checkpoint rejects curl/headless requests. Attribute third-party preview-toolbar exceptions by their stack URL rather than hiding all page errors. Compare an exact artwork element crop for reduced-motion proof; full screenshots include animated preview chrome.

pnpm deployment installs

  • Treat a failed frozen install as a deployment blocker even if invoking Next directly builds successfully. For ERR_PNPM_IGNORED_BUILDS, inspect the exact dependency lifecycle scripts and the tracked pnpm-workspace.yaml; pnpm may generate ignored placeholder decisions locally. Commit explicit reviewed version-scoped allow/deny decisions, keep strict checking enabled for unknown versions, and verify the normal frozen-install/build path before redeploying.

Don't

  • Rewrite code speculatively before reading logs.
  • Report fixed without re-checking the runtime.

© OutThisLife, MIT. 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 skills/runtime-debug of OutThisLife/brooklyn-skills.

Open the folder on GitHubat commit 8a97904

Compare with similar skills

Runtime Debug 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.

Runtime Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Runtime Debug this skillOutThisLife/brooklyn-skills199—~777Automated safety check: PassMIT
Deploy Observabilityaliyun/alibabacloud-observability-mcp-server166—~2.6kAutomated safety check: NotesNone
Temps Best Practicesgotempsh/temps826—~2.9kAutomated safety check: PassApache-2.0
Linux Troubleshooting with Inspektor Gadgetinspektor-gadget/inspektor-gadget2.9k—~2.4kAutomated safety check: NotesApache-2.0
New Pluginapache/skywalking-python219—~3.3kAutomated safety check: PassApache-2.0
Logfire Infrastructurepydantic/skills140—~1.8kAutomated safety check: PassMIT

Similar skills

  • Deploy Observability

    aliyun/alibabacloud-observability-mcp-server

    Deploy, start, and update the Alibaba Cloud Observability MCP Server (阿里云可观测 MCP Server).

    166 GitHub stars~2.6k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Temps Best Practices

    gotempsh/temps

    Best-practices reference for preparing and instrumenting applications on Temps.

    826 GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Linux Troubleshooting with Inspektor Gadget

    inspektor-gadget/inspektor-gadget

    Debugs a single Linux host or container runtime at the kernel level with the standalone ig binary and eBPF gadgets, read-only and without Kubernetes.

    2.9k GitHub stars~2.4k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • New Plugin

    apache/skywalking-python

    Scaffold a new SkyWalking Python instrumentation plugin with all required files (plugin code, tests, docker-compose, expected data, services)

    219 GitHub stars~3.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Logfire Infrastructure

    pydantic/skills

    Official

    Monitor hosts, Docker containers, Kubernetes clusters, database/queue/cache servers, and cloud-provider metrics with Pydantic Logfire — no application code required.

    140 GitHub stars~1.8k tokensUpdated 7 days ago
    DevOps & CloudAuto-check passed
  • Plugin Test

    apache/skywalking-python

    Build Docker test images and run SkyWalking Python plugin/unit/e2e tests locally, mirroring the CI pipeline

    219 GitHub stars~2.3k tokensUpdated today
    DevOps & CloudAuto-check passed

More from OutThisLife/brooklyn-skills

All 22 skills in this repo
  • Draft Tweet

    OutThisLife/brooklyn-skills

    Draft X/Twitter posts about shipped work. An agent skill from OutThisLife/brooklyn-skills.

    199 GitHub stars~456 tokensUpdated 2 days ago
    Auto-check passed
  • Free Disk Space

    OutThisLife/brooklyn-skills

    Safely reclaim disk space on macOS without touching personal or agent data.

    199 GitHub stars~433 tokensUpdated 2 days ago
    Auto-check passed
  • List Open Work

    OutThisLife/brooklyn-skills

    List my open MRs/PRs in the current repo/worktree, each with its tracker ticket.

    199 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • PR Ready

    OutThisLife/brooklyn-skills

    Clear everything blocking an existing PR/MR from merging — rebase onto the default branch, get CI green, and resolve review threads (Copilot and human).

    199 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • PR Triage

    OutThisLife/brooklyn-skills

    Maintainer triage on OTHER people's PRs/MRs — verdict of approve, supersede, or close, salvage with credit, close the cluster.

    199 GitHub stars~4.7k tokensUpdated 2 days ago
    Auto-check passed
  • PR Update

    OutThisLife/brooklyn-skills

    Open a PR/MR if missing, or refresh an existing one's title and description so they match the current diff.

    199 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check: notes

Works with

Categories

Questions about Runtime Debug

What does Runtime Debug do?

Debug broken runtime/environments by checking logs and observability first, then code. Runtime Debug is an agent skill from OutThisLife/brooklyn-skills. Debug broken runtime/environments by checking logs and observability first, then code.

When should I use Runtime Debug?

Runtime Debug fits situations like: ephemeral/CI environment fails at runtime rather than a local code bug; tasks that involve Observability.

How do I install Runtime Debug in Claude Code?

Run `npx skills add OutThisLife/brooklyn-skills --skill runtime-debug -a claude-code`. Or copy the skill folder (skills/runtime-debug in OutThisLife/brooklyn-skills) into .claude/skills/runtime-debug in your project. Claude Code loads it when a task matches its description.

How do I install Runtime Debug in Codex?

Run `npx skills add OutThisLife/brooklyn-skills --skill runtime-debug -a codex`. Or copy the skill folder (skills/runtime-debug in OutThisLife/brooklyn-skills) into .agents/skills/runtime-debug in your project. Codex loads it when a task matches its description.

Can I use Runtime Debug 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 OutThisLife/brooklyn-skills --skill runtime-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/runtime-debug, .gemini/skills/runtime-debug, .github/skills/runtime-debug and .opencode/skills/runtime-debug in your project.

What does Runtime Debug need to run?

SKILL.md names no scripts, command-line tools or credentials: Runtime Debug is instructions for the agent only. Our summary lists: Docker.

Does Runtime Debug 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 Runtime Debug 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 Runtime Debug use?

Runtime Debug is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Runtime Debug use?

About 777 tokens (SKILL.md is roughly 3.1k 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 Runtime Debug?

Skills that share tags, products or a category with Runtime Debug: Deploy Observability (aliyun/alibabacloud-observability-mcp-server, 166 stars), Temps Best Practices (gotempsh/temps, 826 stars), Linux Troubleshooting with Inspektor Gadget (inspektor-gadget/inspektor-gadget, 2.9k stars) and New Plugin (apache/skywalking-python, 219 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Runtime Debug?

OutThisLife (a GitHub user) maintains it in OutThisLife/brooklyn-skills, which has 199 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 5, 2026.

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