skills.rest
reez455G
reez455GCOMMUNITY
Explore all skills by this author →
GitHub

agent-troubleshoot

Diagnose agent session issues like database locks, tool timeouts, and missing dependencies.

Updated Jul 7, 2026
Search Tags:#dependency check#system diagnostics#network troubleshooting#agent troubleshooting#database lock resolution
One-click install
npx skills add https://github.com/reez455G/my-ai-agents --skill agent-troubleshoot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-troubleshoot
Source: https://github.com/reez455G/my-ai-agents/tree/main/.omp/skills/agent-troubleshoot
Command: npx skills add https://github.com/reez455G/my-ai-agents --skill agent-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and resolve common issues in agent sessions, such as database locks, tool timeouts, and missing system dependencies.

Core Features & Use Cases

  • System Health Check: Identifies process-level failures with journalctl.
  • Dependency Verification: Checks for the presence of rg or find on the host.
  • Database Contention Resolution: Terminates processes holding database locks.
  • Network/API Error Handling: Verifies provider health and network connectivity.

Quick Start

Run the agent-troubleshoot skill to diagnose issues with the current agent session.

Frequently Asked Questions about agent-troubleshoot

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

FAQPage Schema
How do I resolve database locks and tool timeouts in an agent session?▼

To resolve agent session issues like database locks and tool timeouts, you can run a troubleshooting skill that terminates locking processes and checks system health using journalctl.

Why does my agent session fail when system dependencies are missing?▼

Agent sessions fail when system dependencies are missing because required command-line tools are absent. Diagnostics verify the presence of necessary host utilities like rg or find to ensure proper execution.

What is the best way to diagnose network connectivity and API errors during agent troubleshooting?▼

Diagnosing network connectivity and API errors involves verifying external provider health and checking network paths. This ensures agent session failures are not caused by unreachable external services.

Can I check for process-level system health failures using journalctl?▼

Yes, you can check for process-level system health failures using journalctl. It queries system logs to identify underlying process failures causing agent session disruptions.

How do I identify and terminate processes holding database contention locks?▼

To identify and terminate processes holding database contention locks, utilize system diagnostics to detect blocking processes and execute commands to kill them, resolving session freezes.

Related Skills

Explore More Software Engineering Skills→
atournayreatournayre

orchestrator:check-prerequisites

Verify gh CLI, jq, and git availability before automated workflows.

Community
Basic
hiddink-aihiddink-ai
1

mock-core-skill

Validate core-scoped skill loading and execution within the agent harness.

Official
Basic
X-McKayX-McKay
3

diagnose-network-issue

Diagnose Kubernetes pod network connectivity issues via DNS, service, and policy checks.

Community
Intermediate
RafalekSRafalekS
1

agent-builder

Guide creation, refinement, and troubleshooting of Claude Code subagents.

Community
Advanced