GitHunt
FR

frieder/cc-devops-skills

DevOps Skills for Claude Code

A comprehensive collection of Claude Code skills for DevOps engineers, providing generators and validators for infrastructure automation, CI/CD pipelines, container orchestration, and observability tooling.

Mentioned in Awesome Claude Code

What are Claude Code Skills?

Skills are reusable prompt templates that help Claude provide expert guidance on specific topics. When you invoke a skill, Claude assumes the role of an expert in that domain and provides detailed, actionable advice with automatic validation.

Available Skills (31 skills)

Ansible (2 skills)

Skill Description
ansible-generator Generate production-ready Ansible playbooks, roles, tasks, and inventory files following best practices
ansible-validator Validate, lint, and test Ansible playbooks and roles using ansible-lint and syntax checks

Azure Pipelines (2 skills)

Skill Description
azure-pipelines-generator Generate best practice Azure DevOps Pipelines for CI/CD workflows
azure-pipelines-validator Validate, lint, and secure Azure DevOps Pipeline configurations

Bash Scripts (2 skills)

Skill Description
bash-script-generator Generate best practice bash scripts with proper error handling and portability
bash-script-validator Validate, lint, and optimize bash and shell scripts for syntax and security

Docker (2 skills)

Skill Description
dockerfile-generator Generate production-ready Dockerfiles with multi-stage builds and security hardening
dockerfile-validator Validate Dockerfiles using hadolint and Checkov for security and best practices

Fluent Bit (2 skills)

Skill Description
fluentbit-generator Generate Fluent Bit configurations for log collection and forwarding pipelines
fluentbit-validator Validate Fluent Bit configurations for syntax, security, and best practices

GitHub Actions (2 skills)

Skill Description
github-actions-generator Generate GitHub Actions workflows and custom actions (composite, Docker, JavaScript)
github-actions-validator Validate GitHub Actions workflows using actionlint and test with act

GitLab CI (2 skills)

Skill Description
gitlab-ci-generator Generate GitLab CI/CD pipelines following best practices
gitlab-ci-validator Validate, lint, and secure GitLab CI/CD pipeline configurations

Helm (2 skills)

Skill Description
helm-generator Generate Helm charts with proper templating, values, and chart structure
helm-validator Validate and lint Helm charts with automatic CRD documentation lookup

Jenkins (2 skills)

Skill Description
jenkinsfile-generator Generate Jenkinsfiles for Declarative and Scripted pipeline syntaxes
jenkinsfile-validator Validate and lint Jenkinsfile pipelines for syntax and best practices

Kubernetes (3 skills)

Skill Description
k8s-generator Generate Kubernetes YAML manifests with automatic CRD documentation lookup
k8s-yaml-validator Validate Kubernetes manifests using kubeconform and yamllint
k8s-debug Debug Kubernetes cluster issues with systematic troubleshooting workflows

Logging & Observability (3 skills)

Skill Description
logql-generator Generate LogQL queries for Loki log analysis and alerting
loki-config-generator Generate Loki configuration files for log aggregation
promql-generator Generate PromQL queries for Prometheus monitoring and alerting

Makefiles (2 skills)

Skill Description
makefile-generator Generate best practice Makefiles for build automation
makefile-validator Validate, lint, and optimize Makefiles for syntax and best practices

PromQL (1 skill)

Skill Description
promql-validator Validate PromQL queries for syntax and best practices

Terraform (2 skills)

Skill Description
terraform-generator Generate Terraform configurations following best practices
terraform-validator Validate Terraform configurations with fmt, validate, and tflint

Terragrunt (2 skills)

Skill Description
terragrunt-generator Generate Terragrunt configurations for multi-environment deployments
terragrunt-validator Validate Terragrunt configurations and DRY patterns

Installation

Add this repository as a Claude Code plugin marketplace and install the skills:

# Add the marketplace
/plugin marketplace add akin-ozer/cc-devops-skills

# Install the plugin
/plugin install devops-skills@akin-ozer

Or browse available plugins interactively with /plugin.

Team Installation

To automatically install for your team, add to your project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "devops-skills": {
      "source": {
        "source": "github",
        "repo": "akin-ozer/cc-devops-skills"
      }
    }
  }
}

When team members trust the repository folder, Claude Code automatically installs the marketplace.

Now available for Codex desktop 🎉

$skill-installer install https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills

How to Use

Invoking a Skill

Simply ask Claude to use a skill by name:

Use the dockerfile-generator skill to create a Dockerfile for my Node.js application

Or ask Claude to validate an existing file:

Validate my terraform configuration using the terraform-validator skill

Generator + Validator Workflow

Most skills come in pairs (generator + validator). When you use a generator skill, it automatically validates the output:

  1. Generator creates the resource following best practices
  2. Validator checks for syntax errors, security issues, and best practices
  3. Generator fixes any validation errors
  4. Final output is production-ready and validated

Skill Categories

By Function

  • Generators: Create new resources from scratch following best practices
  • Validators: Validate, lint, and secure existing resources
  • Debug/Troubleshooting: Diagnose and fix issues in running systems

By Technology Area

Infrastructure as Code
├── Terraform (generator, validator)
├── Terragrunt (generator, validator)
└── Ansible (generator, validator)

Container & Orchestration
├── Dockerfile (generator, validator)
├── Kubernetes (generator, validator, debug)
└── Helm (generator, validator)

CI/CD Pipelines
├── GitHub Actions (generator, validator)
├── GitLab CI (generator, validator)
├── Jenkins (generator, validator)
└── Azure Pipelines (generator, validator)

Observability
├── PromQL (generator, validator)
├── LogQL (generator)
├── Fluent Bit (generator, validator)
└── Loki Config (generator)

Build & Scripting
├── Makefile (generator, validator)
└── Bash Script (generator, validator)

By Experience Level

Level Skills
Beginner-friendly dockerfile-generator, bash-script-generator, makefile-generator
Intermediate terraform-generator, ansible-generator, github-actions-generator, k8s-generator
Advanced helm-generator, terragrunt-generator, k8s-debug, promql-generator

Key Features

Automatic Validation

All generator skills automatically validate their output using the corresponding validator skill, ensuring production-ready results.

Version-Aware Documentation

Skills automatically fetch up-to-date documentation for:

  • Custom Resource Definitions (CRDs) in Kubernetes
  • Terraform providers and modules
  • Ansible collections and modules
  • CI/CD actions and plugins

Best Practices Enforcement

Each skill enforces domain-specific best practices:

  • Security hardening
  • Resource optimization
  • Naming conventions
  • Idempotency guarantees

Skill Structure

Each skill in .claude/skills/ contains:

skill-name/
├── SKILL.md           # Main skill prompt with instructions
├── references/        # Best practices and troubleshooting guides
├── scripts/           # Helper scripts for validation
├── assets/            # Templates and configuration files
└── test/              # Test files for validation

Contributing

These skills are designed to evolve with DevOps best practices. Contributions welcome:

  • Add new skills for emerging technologies
  • Update existing skills with new best practices
  • Improve validation scripts and references
  • Add test cases for better coverage

Best Practices for Using Skills

  1. Be specific: Provide context about your environment, requirements, and constraints
  2. Share files: Upload relevant configuration files for Claude to review
  3. Ask follow-ups: Skills are starting points - ask for clarification or alternatives
  4. Combine skills: Use generators and validators together for best results
  5. Iterate: Refine the output by providing feedback

Requirements

Skills leverage MCP (Model Context Protocol) servers for enhanced functionality:

MCP Server Purpose Used By
Context7 Fetch up-to-date documentation for CRDs, Terraform providers, Ansible collections k8s-generator, helm-generator, terraform-generator, ansible-generator

Context7 enables skills to automatically look up version-aware documentation for custom resources, ensuring generated configurations are accurate and up-to-date.

CLI Tools by Skill

Infrastructure as Code

Tool Skills Installation
terraform terraform-generator, terraform-validator brew install terraform
tflint terraform-validator brew install tflint
terragrunt terragrunt-generator, terragrunt-validator brew install terragrunt
checkov terraform-validator, dockerfile-validator pip install checkov (Python 3.9+)
ansible-lint ansible-generator, ansible-validator pip install ansible-lint
ansible ansible-validator pip install ansible

Container & Kubernetes

Tool Skills Installation
hadolint dockerfile-validator brew install hadolint
helm helm-generator, helm-validator brew install helm (v3+)
kubeconform k8s-yaml-validator, helm-validator brew install kubeconform
kubectl k8s-debug, k8s-yaml-validator brew install kubectl
yamllint k8s-yaml-validator, helm-validator, ansible-validator pip install yamllint

CI/CD Pipelines

Tool Skills Installation
actionlint github-actions-validator brew install actionlint
act github-actions-validator brew install act

Scripting & Build

Tool Skills Installation
shellcheck bash-script-validator brew install shellcheck
make makefile-validator Usually pre-installed

Observability

Tool Skills Installation
promtool promql-validator Part of Prometheus: brew install prometheus
fluent-bit fluentbit-validator brew install fluent-bit (optional, for dry-run)

Optional Tools

These tools provide additional functionality but are not strictly required:

Tool Purpose Installation
yq YAML manipulation and querying brew install yq
helm-diff Preview Helm upgrade changes helm plugin install https://github.com/databus23/helm-diff
molecule Ansible role testing pip install molecule
docker Required for act to test GitHub Actions locally brew install docker

Python Requirements

Many validation scripts require Python:

  • Python 3.8+ - Required for most validation scripts
  • Python 3.9+ - Required for Checkov

Quick Install (macOS with Homebrew)

# Core tools
brew install terraform tflint terragrunt helm kubeconform kubectl yamllint
brew install hadolint actionlint act shellcheck prometheus

# Python tools (use pipx for isolation)
pipx install ansible-lint checkov yamllint

# Optional
brew install yq fluent-bit
helm plugin install https://github.com/databus23/helm-diff

Quick Install (Linux)

# Python tools
pip install ansible-lint checkov yamllint

# Other tools - see individual tool documentation for Linux installation
# Most tools provide binary releases on GitHub

License

Apache 2.0