gitops-repo-audit

Scan local Flux CD manifests to validate Kubernetes schemas and detect deprecated APIs.

Updated Jul 23, 2025
One-click install
npx skills add https://github.com/Sandesh-Solabannavar/flux-homelab --skill gitops-repo-audit-sandesh-solabannavar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitops-repo-audit
Source: https://github.com/Sandesh-Solabannavar/flux-homelab/tree/main/.agents/skills/gitops-repo-audit
Command: npx skills add https://github.com/Sandesh-Solabannavar/flux-homelab --skill gitops-repo-audit-sandesh-solabannavar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires awk, flux, yq, kustomize, kubeconform, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Audit Flux CD GitOps repositories by scanning local repo files to validate Kubernetes manifests, detect deprecated Flux APIs, review RBAC/multi-tenancy/secrets management, and produce a prioritized GitOps report.

Core Features & Use Cases

  • Validate manifests against Kubernetes OpenAPI schemas and Flux CRDs in a local repository.
  • Detect deprecated Flux API versions and provide migration guidance.
  • Assess RBAC, multi-tenancy, secret management, and source authentication to improve security postures.
  • Generate a prioritized GitOps report with actionable remediation steps for teams.
  • Use cases include security reviews, compliance checks, and pre-merge validation of Flux repos.

Quick Start

Run the audit workflow on your Flux CD repository locally to obtain a structured assessment report.

Frequently Asked Questions about gitops-repo-audit

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

FAQPage Schema
How do I audit a Flux CD GitOps repository for security issues locally?

You can audit Flux CD GitOps repositories by running static scans on local manifests to validate Kubernetes schemas, detect deprecated Flux APIs, and review RBAC and secret management. This generates a prioritized report with actionable remediation steps.

What is the best way to check for deprecated Flux API versions in my GitOps repo?

The best way to check for deprecated Flux API versions is by performing static scans of your local repository files. This process detects outdated Flux API versions and provides specific migration guidance to update your GitOps configuration.

Do I need kustomize and kubeconform to validate Kubernetes manifests in a Flux repo?

Validating Kubernetes manifests in a Flux repo uses dependencies like kustomize and kubeconform, along with awk, flux, and yq. These tools enable static schema validation against Kubernetes OpenAPI schemas and Flux CRDs.

Can I review multi-tenancy and RBAC configurations for Kubernetes GitOps repositories?

You can review multi-tenancy and RBAC configurations for Kubernetes GitOps repositories. The audit assesses RBAC, multi-tenancy, secret management, and source authentication to improve your security posture across monorepo and multi-repo patterns.

Does the GitOps audit workflow support monorepo and multi-repo Flux patterns?

The GitOps audit workflow supports both monorepo and multi-repo Flux patterns. It applies static scanning to clusters of Flux resources within these structural patterns to enforce API compliance and assess security best practices.

Why validate Kubernetes OpenAPI schemas before merging Flux CD changes?

Validating Kubernetes OpenAPI schemas before merging Flux CD changes ensures manifests are correctly structured and compliant. Pre-merge validation catches security issues, deprecated APIs, and RBAC misconfigurations early in the development lifecycle.