debug

Execute diagnostic and test commands inside a Docker container via a file-based relay.

Updated May 23, 2026
One-click install
npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill debug-yo-steven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/yo-steven/skills-exploration-20260522/tree/main/skills/Model-Optimizer/debug
Command: npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill debug-yo-steven

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The debug skill eliminates the friction of reproducing issues locally by letting you execute commands inside a Docker environment that shares the same repository filesystem, so you can validate behavior where it actually runs.

Core Features & Use Cases

  • Remote command execution via file-based relay: Send commands to a pre-started container so you can inspect runtime state and outputs.
  • GPU/container-friendly diagnostics: Run checks like verifying available hardware (for example, running nvidia-smi) and executing tests in the same environment.
  • Use Case: When a training or inference run fails on GPU, use this skill to rerun the failing command in the container and confirm dependencies, environment variables, and logs.

Quick Start

Run the container-side server first, then ask the debug skill to execute the command you need inside the already-running Docker container.

Frequently Asked Questions about debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run pytest inside a Docker container to reproduce environment-dependent failures?

To run pytest inside a Docker container, start the container-side server first, then use the file-based command relay to send and execute the test command safely within the matching repository filesystem and runtime environment.

How do I execute remote commands inside a Docker container for debugging?

Remote command execution inside a Docker container uses a file-based command relay to send commands to a pre-started server, utilizing a handshake, run, and cancel mechanism with optional timeout to run commands safely and predictably.

How do I run GPU diagnostics like nvidia-smi inside a running Docker container?

You can execute GPU diagnostics like nvidia-smi inside a Docker container by starting the server first, then relaying the command through the client handshake to inspect available hardware and verify runtime state.

What is the best way to debug a failing training run in a containerized environment?

Debugging a failing training run in a containerized environment involves rerunning the failing command inside the Docker container to confirm dependencies, environment variables, and logs where the code actually runs.

Do I need to start a server before running commands in a Docker container?

Yes, you must start the container-side server first before using the client to send commands, ensuring the file-based relay can successfully handshake and execute commands inside the running Docker container.

Can I use a timeout to safely run commands inside a container?

Yes, you can use an optional timeout when running commands inside a container to ensure safe and predictable execution, utilizing the client run and cancel mechanisms to halt operations if needed.