self-improving-operations

Capture operational learnings into structured markdown entries and promote recurring patterns.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/jose-compu/self-improving-skills --skill self-improving-operations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-improving-operations
Source: https://github.com/jose-compu/self-improving-skills/tree/main/self-improving-operations
Command: npx skills add https://github.com/jose-compu/self-improving-skills --skill self-improving-operations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Capture and organize operational learnings from incidents, toil, capacity events, and automation gaps into structured, searchable markdown entries.

Core Features & Use Cases

  • Log learnings to .learnings/ files (LEARNINGS.md, OPERATIONS_ISSUES.md, FEATURE_REQUESTS.md) for ongoing improvement.
  • Promote recurring patterns to runbooks, incident postmortems, automation backlog, capacity models, on-call handoff checklists, or SLO definitions.
  • Integrate with hooks and templates to automate capture across multi-agent environments and cross-skill references.

Quick Start

Record learnings after an operational event and promote recurring patterns to runbooks, postmortems, automation backlog, capacity models, or SLO definitions.

Frequently Asked Questions about self-improving-operations

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

FAQPage Schema
How do I capture operational learnings from incidents into a structured format?

You capture operational learnings by logging incidents, toil, and capacity events into structured markdown entries within .learnings/ files. This creates a searchable knowledge base of reliability issues that teams can reference during future events.

What is the best way to turn recurring incident patterns into runbooks?

The best way to turn recurring incident patterns into runbooks is by promoting repeated learnings from your .learnings/ files. Once a pattern surfaces multiple times, you elevate that entry into a formal runbook, postmortem, or SLO definition for repeatable reliability.

Can I use markdown files to track operational issues and feature requests together?

Yes, you can use markdown files to track operational issues and feature requests together. The Skill logs ongoing improvements to LEARNINGS.md, OPERATIONS_ISSUES.md, and FEATURE_REQUESTS.md, organizing both operational toil and automation gaps in one searchable structure.

How do automation hooks work with operational learnings capture?

Automation hooks integrate with templates to capture operational learnings automatically across multi-agent environments. These hooks support cross-skill references and standardized metadata, ensuring teams reliably extract and reuse knowledge without manual entry after every event.

When should I promote operational learnings to capacity models or SLO definitions?

You should promote operational learnings to capacity models or SLO definitions when recurring patterns emerge from logged incidents and toil. Recognizing repeated capacity events or reliability gaps signals that the learning needs elevation to a formalized operational standard.

Does this approach work for capturing toil and capacity events across multiple domains?

Yes, this approach works for capturing toil and capacity events across multiple domains. It applies domain-agnostic logging to .learnings/ files and promotes recurring patterns to runbooks, automation backlogs, and SLO definitions, supporting cross-domain operational visibility.