How does this skill handle kubectl commands?

It ensures the --context flag is used as the first argument and utilizes $MC_CONTEXT or $WC_CONTEXT variables to maintain operational safety.

What is the primary purpose of the runbook-standards skill?

It provides specialized guidance for creating and maintaining high-quality operational runbooks according to Giant Swarm's specific internal standards.

Does it support dynamic Grafana links?

Yes, it provides a specific format for adding MC-aware dynamic links in the front matter that become clickable when variables are set.

Can I use standard Markdown code blocks with this skill?

No, the skill enforces the use of Hugo's highlight shortcodes to provide features like syntax highlighting, copy buttons, and line numbers.

Giant Swarm Runbook Standards

Name: Giant Swarm Runbook Standards
Author: giantswarm

bygiantswarm

0•

Learning & Documentation

Enforces quality standards and best practices for creating, migrating, and maintaining Giant Swarm operational runbooks.

The Runbook Standards skill ensures all documentation within the Giant Swarm ecosystem adheres to specific quality and formatting requirements. It provides automated guidance for required front matter, interactive variable definitions for kubectl commands, and proper Hugo shortcode usage for code blocks and internal links. By standardizing the structure of runbooks, this skill helps engineers create actionable, error-free documentation that integrates seamlessly with Giant Swarm's internal support tools and dashboard systems.

Key Features

01Configuration guidance for MC-aware dynamic dashboard links

020 GitHub stars

03Enforcement of kubectl context-first command standards

04Support for interactive INSTALLATION and CLUSTER variables

05Automated front matter validation and metadata generation

06Standardized Hugo highlight and relref shortcode implementation

Use Cases

01Migrating legacy ops-recipes to the standardized runbook directory

02Updating existing runbooks to support interactive variables and dashboard links

03Creating a new operational runbook with correct metadata and formatting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add giantswarm/claude-code runbook-standards

For use in Claude.ai and ChatGPT

Download Skill