Agent skill
runbook
Generate operational runbooks for services, procedures, or incident response
Install this agent skill to your Project
npx add-skill https://github.com/thoreinstein/opencode-config/tree/main/skill/runbook
SKILL.md
Operational Runbook Generator
Current Time: !date
K8s Context: !kubectl config current-context
Generate operational runbooks for services, procedures, or incident response. Investigates the codebase and infrastructure to produce accurate, actionable procedures. Documents to Obsidian.
Input
- Topic: service name, operation type, or incident scenario
- Scope: deployment, scaling, failover, maintenance, troubleshooting
- Optional: specific scenarios to cover
Investigation Strategy
Launch parallel investigation tracks:
Track 1: Codebase Exploration (explore agent)
- Identify service entry points and configuration
- Find health check endpoints
- Map dependencies (databases, caches, external services)
- Locate logging and metrics instrumentation
- Find existing scripts or automation
Track 2: Infrastructure Analysis (inferred agent: k8s/sre/gcp-dev)
- Review deployment manifests
- Identify scaling configuration
- Map service dependencies
- Find monitoring and alerting setup
- Review backup and recovery procedures
Track 3: External Research (librarian agent)
- Find operational best practices for the service type
- Research common failure modes
- Identify industry-standard procedures
Output
Write to Obsidian via obsidian_append_content at:
$OBSIDIAN_PATH/Runbooks/YYYY-MM-DD-service-operation.md
Note:
$OBSIDIAN_PATHmust be a vault-relative path (e.g.,Projects/myapp), set per-project via direnv. Theobsidian_append_contenttool expects paths relative to the vault root.
Document Structure
Use this template for the Obsidian document:
@~/.config/opencode/templates/runbook.md
Behavior
- Parse topic to identify service and operation scope
- Infer appropriate infrastructure agent (k8s, sre, gcp-dev)
- Launch explore, librarian, and inferred agent in parallel
- Extract configuration, endpoints, and dependencies from codebase
- Identify common operations and failure modes
- Generate step-by-step procedures with actual commands
- Write runbook to Obsidian via
obsidian_append_contentwith auto-generated filename:YYYY-MM-DD-service-operation.md
$ARGUMENTS
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
thoreinstein/opencode-config
seo
Implement SEO optimizations for specified pages or entire site
thoreinstein/opencode-config
file-organizer
Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.
thoreinstein/opencode-config
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
thoreinstein/opencode-config
ultrathink
Ultra-deep multi-perspective analysis for complex architectural and strategic decisions
thoreinstein/opencode-config
commit
Analyze unstaged changes and suggest atomic commit groups with messages
thoreinstein/opencode-config
meeting-insights-analyzer
Analyzes meeting transcripts and recordings to uncover behavioral patterns, communication insights, and actionable feedback. Identifies when you avoid conflict, use filler words, dominate conversations, or miss opportunities to listen. Perfect for professionals seeking to improve their communication and leadership skills.
Didn't find tool you were looking for?