skills.rest
DingyangLyu
DingyangLyuCOMMUNITY
Explore all skills by this author →
GitHub

debug

Diagnoses Docker/AJSHA client container and agent-run failures including authentication, mounts, permissions, sessions, and MCP/SDK errors.

85|23|Updated Mar 7, 2026
Search Tags:#authentication#logs#debug#docker#container#sessions#mounts
One-click install
npx skills add https://github.com/DingyangLyu/MatClaw --skill debug-dingyanglyu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/DingyangLyu/MatClaw/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/DingyangLyu/MatClaw --skill debug-dingyanglyu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers and operators diagnose and resolve failures in the MatClaw containerized agent execution environment, including authentication failures, mount and permission errors, missing environment variables, and session resumption problems.

Core Features & Use Cases

  • Log locations & inspection: Enumerates host and per-run container logs to locate errors quickly.
  • Authentication checks: Verifies presence and propagation of CLAUDE/ANTHROPIC credentials and explains how the env file is mounted.
  • Mounts, permissions & session persistence: Shows expected mount targets, ownership requirements for the container user, and how to ensure sessions persist under /home/node/.claude.
  • MCP and SDK troubleshooting: Describes SDK options, permission modes that cause exits, and how to validate MCP server startup.
  • Rebuild & reproduce: Provides commands and a quick diagnostic checklist to rebuild images, run test queries, and validate the runtime environment.

Quick Start

Run the repository's quick diagnostic script to verify authentication, mounts, container image, logs, and session path correctness.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I find authentication failures in a Docker container agent?▼

To diagnose Docker container agent authentication failures, inspect host and per-run container logs to verify CLAUDE and ANTHROPIC credentials are present and properly mounted via the environment file.

Why does my Docker container session fail to resume under the /home/node/.claude path?▼

Docker container session resumption fails when mount targets lack proper ownership permissions for the container user. Verify mount targets and ensure sessions persist correctly under the /home/node/.claude directory.

How to fix environment variable propagation issues in a containerized agent?▼

Fix environment variable propagation issues in containerized agents by running diagnostic commands to rebuild the container image, verifying the environment file mount configuration, and testing that required variables are passed correctly to the runtime environment.

Can I use MCP server troubleshooting steps for Claude SDK permission errors?▼

Yes, MCP server troubleshooting steps apply to Claude SDK permission errors by validating SDK options and identifying permission modes that cause unexpected exits, ensuring MCP server startup is correctly configured within the container environment.

What's the best way to rebuild and test a Docker container image for diagnostic checks?▼

The best way to rebuild and test a Docker container image is to run the repository's quick diagnostic script, which validates authentication, mounts, logs, and session paths, then execute test queries to confirm the runtime environment is correct.

Do I need specific mount permissions to run MatClaw container agents without errors?▼

You need specific mount permissions to run MatClaw container agents without errors. The container requires correct ownership requirements for the container user across expected mount targets to prevent mount and permission failures during execution.

Related Skills

Explore More Software Engineering Skills→
iia-argiia-arg

debug

Diagnose container and sandbox runtime issues via logs and environment checks.

Community
Basic
LIMITLESS-LONGEVITYLIMITLESS-LONGEVITY

debug

Diagnose NanoClaw container failures involving mounts, environment variables, and MCP initialization.

Official
Advanced
NebulaMaoNebulaMao
13

debug

Diagnose containerized AI agent issues via log analysis and configuration checks.

Community
Intermediate
chiptoe-svgchiptoe-svg

debug

Diagnose and resolve failures in NanoClaw containerized agent environments.

Community
Advanced