app-platform-troubleshooting

Diagnose and fix App Platform issues via container shell access and logs.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ClyptAI/Clypt-Backend --skill app-platform-troubleshooting-clyptai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-platform-troubleshooting
Source: https://github.com/ClyptAI/Clypt-Backend/tree/main/.agents/skills/do-app-platform-skills/skills/troubleshooting
Command: npx skills add https://github.com/ClyptAI/Clypt-Backend --skill app-platform-troubleshooting-clyptai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes App Platform issues by providing shell access, log analysis, and diagnostic workflows to accelerate debugging.

Core Features & Use Cases

  • Live shell access to running containers via do_app_sandbox for direct inspection.
  • Logs and diagnostics analysis to identify failures during build, deploy, or runtime.
  • Debug container workflow to isolate infrastructure vs application issues and verify fixes.

Quick Start

Run a live troubleshooting session with the SDK to connect to your app and begin diagnostics.

Frequently Asked Questions about app-platform-troubleshooting

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

FAQPage Schema
How do I troubleshoot a running container on App Platform?

To troubleshoot a running container on App Platform, you use live shell access via the do-app-sandbox SDK for direct inspection. This allows you to interactively diagnose and fix runtime issues within the active deployment.

Why does my App Platform build fail and how can I check the logs?

If your App Platform build fails, you can perform logs-only debugging to identify the exact failure point. Analyzing build and deploy logs helps pinpoint configuration or dependency errors without needing container access.

How do I isolate infrastructure issues from application errors during deployment?

You can isolate infrastructure issues from application errors by using a debug container workflow. This method validates infrastructure separately to determine whether the deployment failure is environment-related or code-related.

Can I use doctl to validate and fix App Platform deployments?

Yes, you can use doctl alongside the do-app-sandbox SDK to diagnose, fix, and validate App Platform deployments. The guided workflow provides mode-based assistance for systematically resolving deployment issues.

What is the best way to diagnose App Platform runtime failures?

The best way to diagnose App Platform runtime failures is by running a live troubleshooting session with the SDK. This connects you directly to your app to analyze logs and inspect the active container state.