wf-diagnose

Diagnose Kubernetes deployment issues on Willform Agent from pod status and logs.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/willform-ai/willform-plugins --skill wf-diagnose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wf-diagnose
Source: https://github.com/willform-ai/willform-plugins/tree/main/skills/wf-diagnose
Command: npx skills add https://github.com/willform-ai/willform-plugins --skill wf-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wf-api.sh, and includes scripts (resource) components.

What problem does it solve?

This Skill helps users quickly identify and troubleshoot issues with their deployments on the Willform Agent, consolidating diagnostic information into a single, actionable report.

Core Features & Use Cases

  • Comprehensive Diagnostics: Gathers pod status, container states, recent events, and resource usage.
  • Log Analysis: Fetches and presents recent container logs for review.
  • Issue Identification: Analyzes common error patterns like ImagePullBackOff, CrashLoopBackOff, and OOMKilled with suggested fixes.
  • Use Case: If a deployment is showing errors or is not running as expected, this Skill can be used to pinpoint the cause by examining its status, logs, and events, providing clear steps for resolution.

Quick Start

Use the wf-diagnose skill to diagnose issues with the deployment named 'my-app'.

Frequently Asked Questions about wf-diagnose

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

FAQPage Schema
How do I diagnose Kubernetes deployment issues like CrashLoopBackOff or ImagePullBackOff?

To diagnose Kubernetes deployment issues like CrashLoopBackOff or ImagePullBackOff, you need to analyze pod status, container states, recent events, and logs. This Skill automates that data gathering and identifies common error patterns to provide recommended actions for resolution.

Why does my Kubernetes deployment keep crashing and how can I check the logs?

If your Kubernetes deployment keeps crashing, you should review recent container logs and resource usage to identify the cause. This Skill fetches recent logs and checks pod status to pinpoint specific container failure reasons, such as OOMKilled, with suggested fixes.

What is the best way to troubleshoot pods that are not running as expected?

The best way to troubleshoot pods that are not running as expected is to consolidate diagnostic information into a single report. This Skill examines deployment status, events, and resource usage to pinpoint the cause and provide clear steps for resolution.

Do I need API configuration to run diagnostics on a specific deployment?

Yes, you need API configuration and deployment identification to run targeted diagnostics. This Skill requires the wf-api.sh dependency to access your environment and gather the diagnostic data needed to analyze the specified deployment.

Can I analyze resource usage and events for Kubernetes deployments on the Willform Agent?

Yes, you can analyze resource usage and events for Kubernetes deployments on the Willform Agent. This Skill gathers comprehensive diagnostics including pod status, container states, recent events, and resource usage to identify common error patterns.

What steps should I follow to pinpoint the cause of a failing deployment?

To pinpoint the cause of a failing deployment, you must examine its status, logs, and events. This Skill requires a deployment name like 'my-app' to gather diagnostic data, identify error patterns, and provide clear steps for resolution.