{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/linux-troubleshooting",
  "version": "1.0.0",
  "name": "Linux Troubleshooting",
  "description": "Linux system troubleshooting workflow for diagnosing and resolving system issues, performance problems, and service failures.",
  "system_prompt_fragment": "# Linux Troubleshooting Workflow\n\n## Overview\n\nSpecialized workflow for diagnosing and resolving Linux system issues including performance problems, service failures, network issues, and resource constraints.\n\n## When to Use This Workflow\n\nUse this workflow when:\n- Diagnosing system performance issues\n- Troubleshooting service failures\n- Investigating network problems\n- Resolving disk space issues\n- Debugging application errors\n\n## Workflow Phases\n\n### Phase 1: Initial Assessment\n\n#### Skills to Invoke\n- `bash-linux` - Linux commands\n- `devops-troubleshooter` - Troubleshooting\n\n#### Actions\n1. Check system uptime\n2. Review recent changes\n3. Identify symptoms\n4. Gather error messages\n5. Document findings\n\n#### Commands\n```bash\nuptime\nhostnamectl\ncat /etc/os-release\ndmesg | tail -50\n```\n\n#### Copy-Paste Prompts\n```\nUse @bash-linux to gather system information\n```\n\n### Phase 2: Resource Analysis\n\n#### Skills to Invoke\n- `bash-linux` - Resource commands\n- `performance-engineer` - Performance analysis\n\n#### Actions\n1. Check CPU usage\n2. Analyze memory\n3. Review disk space\n4. Monitor I/O\n5. Check network\n\n#### Commands\n```bash\ntop -bn1 | head -20\nfree -h\ndf -h\niostat -x 1 5\n```\n\n#### Copy-Paste Prompts\n```\nUse @performance-engineer to analyze system resources\n```\n\n### Phase 3: Process Investigation\n\n#### Skills to Invoke\n- `bash-linux` - Process commands\n- `server-management` - Process management\n\n#### Actions\n1. List running processes\n2. Identify resource hogs\n3. Check process status\n4. Review process trees\n5. Analyze strace output\n\n#### Commands\n```bash\nps aux --sort=-%cpu | head -10\npstree -p\nlsof -p PID\nstrace -p PID\n```\n\n#### Copy-Paste Prompts\n```\nUse @server-management to investigate processes\n```\n\n### Phase 4: Log Analysis\n\n#### Skills to Invoke\n- `bash-linux` - Log commands\n- `error-detective` - Error detection\n\n#### Actions\n1. Check system logs\n2. Review application logs\n3. Search for errors\n4. Analyze log patterns\n5. Correlate events\n\n#### Commands\n```bash\njournalctl -xe\ntail -f /var/log/syslog\ngrep -i error /var/log/*\n```\n\n#### Copy-Paste Prompts\n```\nUse @error-detective to analyze log files\n```\n\n### Phase 5: Network Diagnostics\n\n#### Skills to Invoke\n- `bash-linux` - Network commands\n- `network-engineer` - Network troubleshooting\n\n#### Actions\n1. Check network interfaces\n2. Test connectivity\n3. Analyze connections\n4. Review firewall rules\n5. Check DNS resolution\n\n#### Commands\n```bash\nip addr show\nss -tulpn\ncurl -v http://target\ndig domain\n```\n\n#### Copy-Paste Prompts\n```\nUse @network-engineer to diagnose network issues\n```\n\n### Phase 6: Service Troubleshooting\n\n#### Skills to Invoke\n- `server-management` - Service management\n- `systematic-debugging` - Debugging\n\n#### Actions\n1. Check service status\n2. Review service logs\n3. Test service restart\n4. Verify dependencies\n5. Check configuration\n\n#### Commands\n```bash\nsystemctl status service\njournalctl -u service -f\nsystemctl restart service\n```\n\n#### Copy-Paste Prompts\n```\nUse @systematic-debugging to troubleshoot service issues\n```\n\n### Phase 7: Resolution\n\n#### Skills to Invoke\n- `incident-responder` - Incident response\n- `bash-pro` - Fix implementation\n\n#### Actions\n1. Implement fix\n2. Verify resolution\n3. Monitor stability\n4. Document solution\n5. Create prevention plan\n\n#### Copy-Paste Prompts\n```\nUse @incident-responder to implement resolution\n```\n\n## Troubleshooting Checklist\n\n- [ ] System information gathered\n- [ ] Resources analyzed\n- [ ] Logs reviewed\n- [ ] Network tested\n- [ ] Services verified\n- [ ] Issue resolved\n- [ ] Documentation created\n\n## Quality Gates\n\n- [ ] Root cause identified\n- [ ] Fix verified\n- [ ] Monitoring in place\n- [ ] Documentation complete\n\n## Related Workflow Bundles\n\n- `os-scripting` - OS scripting\n- `bash-scripting` - Bash scripting\n- `cloud-devops` - DevOps",
  "applicable_domains": [
    "other"
  ],
  "category": "other",
  "invocation": [
    "/linux-troubleshooting"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/linux-troubleshooting",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/linux-troubleshooting",
    "license": "unknown",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists."
  },
  "tags": [
    "claudeskills",
    "other",
    "risk-reviewed"
  ],
  "lifecycle": "draft"
}