CtrlK
BlogDocsLog inGet started
Tessl Logo

gitops-repo-audit

Audit and validate Flux CD GitOps repositories by scanning local repo files (not live clusters) — runs Kubernetes schema validation, detects deprecated Flux APIs, reviews RBAC/multi-tenancy/secrets management, and produces a prioritized GitOps report. Use when users ask to audit, analyze, validate, review, or security-check a GitOps repo.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable audit workflow with executable commands, explicit validation checkpoints, and clean one-level-deep progressive disclosure backed by verified bundle files. Only minor verbosity in a few phase descriptions keeps conciseness at 4.

DimensionReasoningScore

Conciseness

Dense and task-focused with no basic-concept padding, but the Phase 1/2 script-output descriptions and a few 'Has X? Check Y' checklist lines are slightly verbose and could be trimmed, so it sits just below the lean top anchor.

4 / 5

Actionability

Fully executable guidance throughout: exact script invocations, a copy-paste mktemp/validate.sh snippet with the -b flag and provenance comments, concrete grep examples, the field-index naming convention, and the migration URL — matching the copy-paste-ready top anchor.

5 / 5

Workflow Clarity

Six numbered phases in a clear sequence with explicit validation checkpoints (validate.sh non-zero exit + 'treat skipped as expected', check-deprecated exit 1, verify-against-field-index before recommending changes) and feedback loops, matching the top anchor.

5 / 5

Progressive Disclosure

SKILL.md is an overview pointing one level deep to 6 reference docs, 3 scripts, and 19 verified field-index files, each signaled via a 'Loading References' section; content is appropriately split and the inline CRD table is a lookup aid rather than bulk material.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A precise, third-person description that concretely enumerates the audit actions and scopes them to local Flux GitOps repos, with an explicit 'Use when...' trigger clause. Only minor trigger-synonym gaps keep trigger term quality at 4.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('runs Kubernetes schema validation', 'detects deprecated Flux APIs', 'reviews RBAC/multi-tenancy/secrets management', 'produces a prioritized GitOps report') with an explicit scope constraint ('scanning local repo files (not live clusters)'), matching the comprehensive-coverage anchor.

5 / 5

Completeness

Explicitly answers both what (five concrete audit actions) and when ('Use when users ask to audit, analyze, validate, review, or security-check a GitOps repo') with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

'Use when users ask to audit, analyze, validate, review, or security-check a GitOps repo' gives good natural-verb coverage, but a few common variations (e.g. 'check', 'Flux repo') are absent, falling just short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is sharply scoped to 'Flux CD GitOps repositories' scanned locally rather than live clusters, with distinct triggers, giving minimal conflict risk with other skills.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 19 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 20 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository
fluxcd/agent-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.