Identifies installed policy engines to manage security rules, check compliance, and review constraint templates.

Install

mkdir -p .claude/skills/k8s-policy && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/5544" && unzip -o skill.zip -d .claude/skills/k8s-policy && rm skill.zip

Installs to .claude/skills/k8s-policy

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Kubernetes policy management with Kyverno and Gatekeeper. Use when enforcing security policies, validating resources, or auditing policy compliance.
148 chars✓ has a “when” trigger
Advanced

Key capabilities

  • →Audits active Kyverno and Gatekeeper engines
  • →Lists policy violations from cluster reports
  • →Retrieves constraint template definitions
  • →Enables validation of manifests against policies

How it works

Interfaces with the Kubernetes API to read custom resources related to policy engines and parse their violation status.

Inputs & outputs

You give it
Namespace or policy engine identifier
You get back
Compliance violation reports or policy configurations

When to use k8s-policy

  • →List all active Kyverno policies
  • →Audit compliance violations in the cluster
  • →Check Gatekeeper constraint templates
  • →Validate resource configurations against policies

About this skill

Kubernetes Policy Management

Manage policies using kubectl-mcp-server's Kyverno and Gatekeeper tools.

Requires the policy toolset: start kubectl-mcp-server with --toolsets default,policy (or MCP_TOOLSETS=default,policy). For deep work, the project-maintained MCP servers may fit better: Kyverno: https://github.com/nirmata/kyverno-mcp.

When to Apply

Use this skill when:

  • User mentions: "Kyverno", "Gatekeeper", "OPA", "policy", "compliance"
  • Operations: enforcing policies, checking violations, policy audit
  • Keywords: "require labels", "block privileged", "validate", "enforce"

Priority Rules

PriorityRuleImpactTools
1Detect policy engine firstCRITICALdetect_ecosystem, detect_ecosystem
2Use Audit mode before EnforceHIGHvalidationFailureAction
3Check policy reports for violationsHIGHget_policy_violations
4Review constraint templatesMEDIUMget_policy_list

Quick Reference

TaskToolExample
List Kyverno cluster policiesget_policy_listget_policy_list()
Get Kyverno policyget_policyget_policy(name)
List Gatekeeper constraintsget_policy_listget_policy_list()
Get constraintget_policyget_policy(kind, name)

Kyverno

Detect Installation

detect_ecosystem()

List Policies

get_policy_list()

get_policy_list(namespace="default")

Get Policy Details

get_policy(name="require-labels")
get_policy(name="require-resources", namespace="default")

Policy Reports

get_policy_violations()

get_policy_violations(namespace="default")

Common Kyverno Policies

kubectl_apply(manifest="""
apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
  name: require-labels
spec:
  validationFailureAction: Enforce
  rules:
  - name: require-app-label
    match:
      resources:
        kinds:
        - Pod
    validate:
      message: "Label 'app' is required"
      pattern:
        metadata:
          labels:
            app: "?*"
""")

kubectl_apply(manifest="""
apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
  name: require-limits
spec:
  validationFailureAction: Enforce
  rules:
  - name: require-cpu-memory
    match:
      resources:
        kinds:
        - Pod
    validate:
      message: "CPU and memory limits required"
      pattern:
        spec:
          containers:
          - resources:
              limits:
                cpu: "?*"
                memory: "?*"
""")

Gatekeeper (OPA)

Detect Installation

detect_ecosystem()

List Constraints

get_policy_list()

get_policy_list()

Get Constraint Details

get_policy(
    kind="K8sRequiredLabels",
    name="require-app-label"
)

get_policy(name="k8srequiredlabels")

Common Gatekeeper Policies

kubectl_apply(manifest="""
apiVersion: templates.gatekeeper.sh/v1
kind: ConstraintTemplate
metadata:
  name: k8srequiredlabels
spec:
  crd:
    spec:
      names:
        kind: K8sRequiredLabels
      validation:
        openAPIV3Schema:
          type: object
          properties:
            labels:
              type: array
              items:
                type: string
  targets:
  - target: admission.k8s.gatekeeper.sh
    rego: |
      package k8srequiredlabels
      violation[{"msg": msg}] {
        provided := {label | input.review.object.metadata.labels[label]}
        required := {label | label := input.parameters.labels[_]}
        missing := required - provided
        count(missing) > 0
        msg := sprintf("Missing labels: %v", [missing])
      }
""")

kubectl_apply(manifest="""
apiVersion: constraints.gatekeeper.sh/v1beta1
kind: K8sRequiredLabels
metadata:
  name: require-app-label
spec:
  match:
    kinds:
    - apiGroups: [""]
      kinds: ["Pod"]
  parameters:
    labels: ["app", "env"]
""")

Policy Audit Workflow

detect_ecosystem()
get_policy_list()
get_policy_violations()

Prerequisites

  • Kyverno: Required for Kyverno tools
    kubectl create -f https://github.com/kyverno/kyverno/releases/latest/download/install.yaml
    
  • Gatekeeper: Required for Gatekeeper tools
    kubectl apply -f https://raw.githubusercontent.com/open-policy-agent/gatekeeper/master/deploy/gatekeeper.yaml
    

Related Skills

When not to use it

  • →Creating infrastructure resources directly
  • →Managing non-policy related cluster objects

Prerequisites

Kyverno or Gatekeeper installed in cluster

Limitations

  • →Only as effective as the installed policies
  • →Read-only focus limits remediation capabilities

How it compares

It centralizes security auditing instead of searching for policies across different API groups manually.

Compared to similar skills

k8s-policy side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
k8s-policy (this skill)19moReviewAdvanced
k8s-security19moReviewAdvanced
security-automation110moReviewAdvanced
k8s-security-policies38moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

More by rohitg00

View all by rohitg00 →

Search skills

Search the agent skills registry