stuck

Diagnose frozen or slow local sessions by inspecting process health and generating reports.

Updated May 17, 2026
One-click install
npx skills add https://github.com/tiankong0101-byte/skills-registry --skill stuck-tiankong0101-byte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stuck
Source: https://github.com/tiankong0101-byte/skills-registry/tree/main/skills/stuck
Command: npx skills add https://github.com/tiankong0101-byte/skills-registry --skill stuck-tiankong0101-byte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you investigate when another session on the machine seems frozen, stuck, unusually slow, or unresponsive, so you can understand what is happening without guessing.

Core Features & Use Cases

  • Process Discovery: Finds relevant Claude or CLI-related processes on Windows, macOS, and Linux.
  • Stall Diagnosis: Checks for signs of high CPU, stopped states, zombie processes, I/O hangs, memory pressure, and stuck child processes.
  • Context Gathering: Collects follow-up process details and related debug log clues to explain what the session was doing before it stalled.
  • Report Generation: Produces a clear diagnostic summary with likely causes and next-step recommendations.

Quick Start

Ask the assistant to diagnose the stuck session and summarize the likely cause, relevant process details, and recommended next steps.

Frequently Asked Questions about stuck

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

FAQPage Schema
How do I diagnose a frozen or unresponsive CLI session on my local machine?

Diagnosing a frozen CLI session requires inspecting process states, sampling CPU and memory, and tracing child processes. This skill performs these checks to identify high CPU usage, zombie processes, or I/O hangs without terminating the session.

What causes a process to become stuck or freeze during system investigation?

Processes become stuck due to high CPU usage, stopped states, zombie processes, I/O hangs, memory pressure, or stuck child processes. Identifying these health issues helps explain what the session was doing before it stalled.

Can I check for zombie processes and memory pressure on Windows, macOS, and Linux?

Yes, you can check for zombie processes and memory pressure across Windows, macOS, and Linux. The skill discovers relevant processes on these operating systems and examines them for signs of stalls, stopped states, and I/O hangs.

How do I generate a diagnostic report for a slow session without killing the process?

To generate a diagnostic report for a slow session without killing the process, request an investigation. The skill collects process details and debug log clues, producing a summary with likely causes and recommended next steps without terminating anything.

What is the best way to trace child processes when a session is unresponsive?

The best way to trace child processes during an unresponsive session is to use child-process tracing alongside CPU and memory sampling. This identifies stuck child processes and collects follow-up details to explain the stall.

Does session debugging work when the CPU usage is maxed out by a process?

Yes, session debugging works when CPU usage is maxed out. The skill specifically checks for signs of high CPU usage and memory pressure to determine if these factors are causing the session to freeze or become unusually slow.