wimi321/stuck-session-diagnosis-skill

Latest recorded source activity: April 2, 2026 at 13:22

SkillsMP catalog refreshed: November 12, 2026 at 12:52

skills collected: 1

GitHub stars: 0
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/wimi321/stuck-session-diagnosis-skill.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Stuck Session Diagnosis [![Repo](https://img.shields.io/badge/github-stuck-session-diagnosis-skill-181717?logo=github)](https://github.com/wimi321/stuck-session-diagnosis-skill) [![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE) [![Collection](https://img.shields.io/badge/collection-claude--code--skills--extract-blue)](https://github.com/wimi321/claude-code-skills-extract) Use when another Claude Code session appears frozen, stuck, or abnormally slow and needs process-level diagnosis and reporting. English | [简体中文](./README.zh-CN.md) ## Why This Skill Exists Stuck Session Diagnosis packages a reusable Claude Code workflow as a standalone public skill repository. It is designed for agent teams that want a well-documented, installable, and maintainable capability rather than an internal prompt fragment. ## Highlights - Focused, reusable workflow with a clear trigger boundary - Standalone skill root that works well in agent workspaces - Agent metadata in `agents/openai.yaml` - Public provenance back to the extracted Claude Code source - Bilingual documentation for English and Chinese readers ## What It Is Good At - Diagnose frozen or slow agent sessions - Running the workflow described in `SKILL.md` with explicit boundaries - Producing repeatable outputs for operators and agent runtimes ## Example Requests - Find out why another Claude session on this machine is frozen. - Inspect local agent processes and tell me if one is hung. ## Workflow 1. List candidate agent processes. 2. Check CPU, RSS, state, uptime, and child processes. 3. Sample suspicious processes again to confirm sustained issues. 4. Inspect related debug logs when possible. 5. Produce a concise diagnosis and escalation-ready report. ## Inputs - Observed symptom - Process state - Optional target PID ## Outputs - Diagnosis summary - Evidence from process inspection - Escalation-ready report ## Success Criteria - Suspicious sessions were confirmed rather than guessed. - Supporting process data was captured. - The report is concise and actionable. ## Non-Goals - Killing processes by default - Reporting transient blips as confirmed hangs ## Installation ### Use as a standalone skill Clone this repository and place the repository root in a compatible skill directory. ### Use from a larger collection This skill is also included in the parent collection: - [claude-code-skills-extract](https://github.com/wimi321/claude-code-skills-extract) ## Repository Layout - `SKILL.md`: canonical skill instructions - `README.md`: English project overview - `README.zh-CN.md`: Simplified Chinese project overview - `agents/openai.yaml`: UI-facing metadata for agent runtimes - `references/`: provenance and support notes - `LICENSE`: repository license ## Provenance Derived from `src/skills/bundled/stuck.ts`. ## Related Projects - Parent collection: [claude-code-skills-extract](https://github.com/wimi321/claude-code-skills-extract) - GitHub repository: [stuck-session-diagnosis-skill](https://github.com/wimi321/stuck-session-diagnosis-skill)

Loading the repository README…

Skills in this repository

Software Developers

1 occupation category · 100% classified

skill

occupation

description

updated

stuck-session-diagnosis

Software Developers

Use when another Claude Code session appears frozen, stuck, or abnormally slow and needs process-level diagnosis and reporting.

2026-04-02

Showing 1 of 1 collected skill.