operations

Generate an evidence-derived operational runbook in Markdown and offline HTML from codebase artifacts.

1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill operations-vickysrawat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: operations
Source: https://github.com/vickysrawat/AI-Assisted-development/tree/main/skills/operations
Command: npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill operations-vickysrawat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Support engineers lack a single, trustworthy document to consult during incidents or routine operational tasks, and hand-written runbooks quickly go stale or contain guessed values. This Skill generates a master Operational Runbook directly from architecture docs, configuration, and pipeline/IaC definitions, marking every unknowable value as a visible ⚠ TODO instead of fabricating it. ## Core Features & Use Cases - 16-section runbook generation: Produces at-a-glance summary, Mermaid architecture/dependency maps, environment inventories, secrets and rotation tables, symptom-to-playbook triage trees, failure-mode playbooks, escalation paths, and a command appendix. - Dual output formats: Writes a Markdown source of truth to docs/operations/ plus a self-contained offline HTML companion with a sticky table of contents and optional locally-vendored Mermaid rendering (no CDN). - Evidence-only discipline: Derives every value from read sources; consent-gates source file reads (max 6), never reads readiness/security ledgers, and never invents contacts, URLs, or topology. - Use Case: Before handing an application to a support team, run the skill to produce the runbook a 3am on-call engineer opens first, then close the flagged ⚠ TODO items with the owning team. ## Quick Start Ask the AI to generate an operational runbook for this project using the operations skill.

Frequently Asked Questions about operations

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

FAQPage Schema
How do I generate an operational runbook from my codebase?

Run the operations skill, which reads architecture docs, config files, and pipeline/IaC definitions to produce a 16-section runbook in docs/operations/. It outputs Markdown plus an offline HTML companion, flagging unknown values as ⚠ TODO rather than guessing.

What sections does the generated runbook include?

The runbook covers at-a-glance summary, architecture and dependency maps, environments, access requirements, routine operations (deploy/rollback/restart/migrations), monitoring, secrets rotation, triage trees, failure-mode playbooks, backup/DR, escalation, and a command appendix.

Does the runbook generator read source code files?

Only in a limited, consent-gated way. Steps 1-3 use architecture docs, config, and IaC with no source reads; Step 4 may read up to 6 source files to confirm failure modes, each requiring explicit consent with justification.

Can the HTML runbook work offline without internet access?

Yes, the HTML companion is fully self-contained with inline CSS and no CDN links. Mermaid diagrams render only if a mermaid.min.js is vendored locally at docs/operations/vendor/; otherwise they degrade to readable source text.

What is the difference between the operations runbook and the go-live checklist?

The operations skill produces the ongoing operate-in-prod runbook used during incidents. The separate /go-live skill generates the one-time support-transition acceptance checklist that ingests readiness, security, and code-review ledgers.

Why does the generated runbook contain ⚠ TODO markers?

TODO markers indicate values that require human or live-environment verification, such as on-call contacts, secret expiry dates, or SLA targets. The skill never fabricates these, since a wrong rollback step is more dangerous than a missing one.