Summary Linux system troubleshooting workflow for diagnosing and resolving system issues, performance problems, and service failures.
Linux Troubleshooting Workflow
Overview
Specialized workflow for diagnosing and resolving Linux system issues including performance problems, service failures, network issues, and resource constraints.
When to Use This Workflow
Use this workflow when:
Diagnosing system performance issues
Troubleshooting service failures
Investigating network problems
Resolving disk space issues
Debugging application errors
Workflow Phases
Phase 1: Initial Assessment
Skills to Invoke
bash-linux - Linux commandsdevops-troubleshooter - Troubleshooting
Actions
Check system uptime
Review recent changes
Identify symptoms
Gather error messages
Document findings
Commands
uptime
hostnamectl
cat /etc/os-release
dmesg | tail -50
Copy-Paste Prompts
Use @bash-linux to gather system information
Phase 2: Resource Analysis
Skills to Invoke
bash-linux - Resource commandsperformance-engineer - Performance analysis
Actions
Check CPU usage
Analyze memory
Review disk space
Monitor I/O
Check network
Commands
top -bn1 | head -20
free -h
df -h
iostat -x 1 5
Copy-Paste Prompts
Use @performance-engineer to analyze system resources
Phase 3: Process Investigation
Skills to Invoke
bash-linux - Process commands
server-management - Process management
Actions
List running processes
Identify resource hogs
Check process status
Review process trees
Analyze strace output
Commands ps aux --sort=-%cpu | head -10
pstree -p
lsof -p PID
strace -p PID
Copy-Paste Prompts Use @server-management to investigate processes
Phase 4: Log Analysis
Skills to Invoke
bash-linux - Log commandserror-detective - Error detection
Actions
Check system logs
Review application logs
Search for errors
Analyze log patterns
Correlate events
Commands journalctl -xe
tail -f /var/log/syslog
grep -i error /var/log/*
Copy-Paste Prompts Use @error-detective to analyze log files
Phase 5: Network Diagnostics
Skills to Invoke
bash-linux - Network commandsnetwork-engineer - Network troubleshooting
Actions
Check network interfaces
Test connectivity
Analyze connections
Review firewall rules
Check DNS resolution
Commands ip addr show
ss -tulpn
curl -v http://target
dig domain
Copy-Paste Prompts Use @network-engineer to diagnose network issues
Phase 6: Service Troubleshooting
Skills to Invoke
server-management - Service managementsystematic-debugging - Debugging
Actions
Check service status
Review service logs
Test service restart
Verify dependencies
Check configuration
Commands systemctl status service
journalctl -u service -f
systemctl restart service
Copy-Paste Prompts Use @systematic-debugging to troubleshoot service issues
Phase 7: Resolution
Skills to Invoke
incident-responder - Incident responsebash-pro - Fix implementation
Actions
Implement fix
Verify resolution
Monitor stability
Document solution
Create prevention plan
Copy-Paste Prompts Use @incident-responder to implement resolution
Troubleshooting Checklist
Quality Gates
Related Workflow Bundles
os-scripting - OS scriptingbash-scripting - Bash scriptingcloud-devops - DevOps
Limitations
Use this skill only when the task clearly matches the scope described above.
Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
