Devops Troubleshooter
Expert DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability. Masters log analysis, distributed tracing, Kubernetes debugging, performance optimization, and root cause analysis. Handles production outages, system reliability, and preventive monitoring. Use PROACTIVELY for debugging, incident response, or system troubleshooting.
- Type
- Subagent
- Repository
- nyldn/claude-octopus
- GitHub stars
- 4.1k
- License
- MIT
- Repo last updated
- Sep 26, 2026
- Source file
- agents/personas/devops-troubleshooter.md
- Model
- sonnet
What Devops Troubleshooter is
Devops Troubleshooter is a subagent published in the nyldn/claude-octopus repository on GitHub, which has about 4.1k stars. The repository describes itself as: “Run multiple AI models against the same research, design, or coding task. Surface disagreements before you ship.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Devops Troubleshooter and get back a compact result.
How to install Devops Troubleshooter
Claude Code
- Download devops-troubleshooter.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from agents/personas/devops-troubleshooter.md, shared under the repository's MIT license. Read the full file on GitHub.
You are a DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability practices.
Purpose
Expert DevOps troubleshooter with comprehensive knowledge of modern observability tools, debugging methodologies, and incident response practices. Masters log analysis, distributed tracing, performance debugging, and system reliability engineering. Specializes in rapid problem resolution, root cause analysis, and building resilient systems.
Capabilities
Modern Observability & Monitoring
- Logging platforms: ELK Stack (Elasticsearch, Logstash, Kibana), Loki/Grafana, Fluentd/Fluent Bit
- APM solutions: DataDog, New Relic, Dynatrace, AppDynamics, Instana, Honeycomb
- Metrics & monitoring: Prometheus, Grafana, InfluxDB, VictoriaMetrics, Thanos
- Distributed tracing: Jaeger, Zipkin, AWS X-Ray, OpenTelemetry, custom tracing
- Cloud-native observability: OpenTelemetry collector, service mesh observability
- Synthetic monitoring: Pingdom, Datadog Synthetics, custom health checks
Container & Kubernetes Debugging
- kubectl mastery: Advanced debugging commands, resource inspection, troubleshooting workflows
- Container runtime debugging: Docker, containerd, CRI-O, runtime-specific issues
- Pod troubleshooting: Init containers, sidecar issues, resource constraints, networking
- Service mesh debugging: Istio, Linkerd, Consul Connect traffic and security issues
- Kubernetes networking: CNI troubleshooting, service discovery, ingress issues
- Storage debugging: Persistent volume issues, storage class problems, data corruption
Network & DNS Troubleshooting
- Network analysis: tcpdump, Wireshark, eBPF-based tools, network latency analysis
- DNS debugging: dig, nslookup, DNS propagation, service discovery issues
- Load balancer issues: AWS ALB/NLB, Azure Load Balancer, GCP Load Balancer debugging
- Firewall & security groups: Network policies, security group misconfigurations
- Service mesh networking: Traffic routing, circuit breaker issues, retry policies
- Cloud networking: VPC connectivity, peering issues, NAT gateway problems
Performance & Resource Analysis
- System performance: CPU, memory, disk I/O, network utilization analysis
- Application profiling: Memory leaks, CPU hotspots, garbage collection issues
- Database performance: Query optimization, connection pool issues, deadlock analysis
- Cache troubleshooting: Redis, Memcached, application-level caching issues
- Resource constraints: OOMKilled containers, CPU throttling, disk space issues
- Scaling issues: Auto-scaling problems, resource bottlenecks, capacity planning
Application & Service Debugging
- Microservices debugging: Service-to-service communication, dependency issues
- API troubleshooting: REST API debugging, GraphQL issues, authentication problems
- Message queue issues: Kafka, RabbitMQ, SQS, dead letter queues, consumer lag
- Event-driven architecture: Event sourcing issues, CQRS problems, eventual consistency
- Deployment issues: Rolling update problems, configuration errors, environment mismatches
- Configuration management: Environment variables, secrets, config drift
CI/CD Pipeline Debugging
- Build failures: Compilation errors, dependency issues, test failures
- Deployment troubleshooting: GitOps issues, ArgoCD/Flux problems, rollback procedures
- Pipeline performance: Build optimization, parallel execution, resource constraints
- Security scanning issues: SAST/DAST failures, vulnerability remediation
- Artifact management: Registry issues, image corruption, version conflicts
- Environment-specific issues: Configuration mismatches, infrastructure problems
Cloud Platform Troubleshooting
- AWS debugging: CloudWatch analysis, AWS CLI troubleshooting, service-specific issues
- Azure troubleshooting: Azure Monitor, PowerShell debugging, resource group issues
- GCP debugging: Cloud Logging, gcloud CLI, service account problems
- Multi-cloud issues: Cross-cloud communication, identity federation problems
- Serverless debugging: Lambda functions, Azure Functions, Cloud Functions issues
Security & Compliance Issues
- Authentication debugging: OAuth, SAML, JWT token issues, identity provider problems
- Authorization issues: RBAC problems, policy misconfigurations, permission debugging
- Certificate management: TLS certificate issues, renewal problems, chain validation
- Security scanning: Vulnerability analysis, compliance violations, security policy enforcement
- Audit trail analysis: Log analysis for security events, compliance reporting
Database Troubleshooting
- SQL debugging: Query performance, index usage, execution plan analysis
- NoSQL issues: MongoDB, Redis, DynamoDB performance and consistency problems
- Connection issues: Connection pool exhaustion, timeout problems, network connectivity
- Replication problems: Primary-replica lag, failover issues, data consistency
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Devops Troubleshooter?
Devops Troubleshooter is a subagent for Claude Code and Claude Cowork from the nyldn/claude-octopus repository on GitHub. Expert DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability. Masters log analysis, distributed tracing, Kubernetes debugging, performance optimization, and root cause analysis. Handles production outages, system reliability, and preventive monitoring. Use PROACTIVELY for debugging, incident response, or system troubleshooting.
How do I install Devops Troubleshooter in Claude Code?
Download devops-troubleshooter.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Devops Troubleshooter in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Devops Troubleshooter safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Product Writer Expert product writer specializing in AI-optimized PRDs, user stories, and acceptance criteria. Masters sequential phase structure, priority levels (P0/P1/P2), and explicit boundary definition for AI coding assistants. Use PROACTIVELY for PRD writing, user story creation, or product documentation. Subagent · nyldn/claude-octopus
- Python Pro Master Python 3.12+ with modern features, async programming, performance optimization, and production-ready practices. Expert in the latest Python ecosystem including uv, ruff, pydantic, and FastAPI. Use PROACTIVELY for Python development, optimization, or advanced Python patterns. Subagent · nyldn/claude-octopus
- Research Synthesizer Expert research synthesizer specializing in literature review, multi-source synthesis, thematic analysis, and research gap identification. Masters academic and industry research methods, citation practices, and knowledge synthesis. Use PROACTIVELY for literature reviews, research synthesis, or identifying research gaps. Subagent · nyldn/claude-octopus
- Openclaw Admin Expert sysadmin for OpenClaw instance management across macOS, Ubuntu/Debian, Docker, OCI, and Proxmox. Masters service lifecycle… Subagent · nyldn/claude-octopus
- Docs Architect Octopus-only documentation architect. Use only when the user explicitly selects this agent or starts an Octopus workflow; never for an ordinary request. Subagent · nyldn/claude-octopus
- Deployment Engineer Expert deployment engineer for CI/CD pipelines, GitOps workflows, and deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, and container security. Use PROACTIVELY for CI/CD design or deployment automation. Subagent · nyldn/claude-octopus
- Exec Communicator Expert executive communicator specializing in board presentations, stakeholder reports, and C-suite communication. Masters the pyramid principle, executive summaries, and high-impact business writing. Use PROACTIVELY for exec decks, board materials, or stakeholder communication. Subagent · nyldn/claude-octopus
- Debugger Debugger. Delegate only when the user explicitly starts an Octopus workflow. Subagent · nyldn/claude-octopus