debug-image

Inspect container images and replicate integration test failures via shell access.

3|2|Updated May 20, 2026
One-click install
npx skills add https://github.com/openkaiden/openshell-image-builder --skill debug-image
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-image
Source: https://github.com/openkaiden/openshell-image-builder/tree/main/.agents/skills/debug-image
Command: npx skills add https://github.com/openkaiden/openshell-image-builder --skill debug-image

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves failures in integration tests by providing a structured workflow to inspect, verify, and debug container images built by the OpenShell image builder.

Core Features & Use Cases

  • Interactive Inspection: Drop into a shell inside a built container to verify file ownership, environment variables, and binary paths.
  • Test Replication: Replicate integration test commands to isolate failures in policy enforcement or agent configuration.
  • Manual Rebuilds: Quickly rebuild specific image configurations to test fixes without running the full test suite.

Quick Start

Use the debug-image skill to open an interactive root shell inside the failing integration test image.

Frequently Asked Questions about debug-image

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

FAQPage Schema
How do I inspect filesystem state and environment variables in a container image?

To inspect filesystem state and environment variables in a container image, you can open an interactive root shell inside the built container to directly verify file ownership, binary paths, and configurations.

How do I reproduce integration test failures in a sandbox environment?

You can reproduce integration test failures in a sandbox environment by manually executing the original test commands through direct container access to isolate policy enforcement or agent configuration issues.

What is the best way to troubleshoot containerized agent images without running the full test suite?

The best way to troubleshoot containerized agent images without the full test suite is to quickly rebuild specific image configurations to test fixes and manually verify the isolated sandbox environment.

Can I use this to verify policy configurations within isolated sandbox environments?

Yes, you can verify policy configurations within isolated sandbox environments by using diagnostic procedures that facilitate direct container execution and shell access to inspect the setup.

Why does my container image built by the OpenShell image builder fail integration tests?

Your container image might fail integration tests due to incorrect filesystem state, misconfigured environment variables, or policy enforcement issues, which can be diagnosed through interactive shell inspection.

What are the limitations of debugging container images through manual shell access?

The limitations of debugging container images through manual shell access include the requirement to manually replicate test commands and the inability to automatically capture transient integration test failures without direct observation.