CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

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.

An excellent operational skill body: fully executable commands with validation checkpoints and error-recovery loops across a clear six-phase workflow, well-organized one-level-deep references verified against the real bundle. The only weakness is minor: a few verbose passages (the discovery JSON shape prose and the large CRD table) could be tightened or moved to reference files.

DimensionReasoningScore

Conciseness

The body is operationally dense with no concept-explainer padding Claude already knows — everything is skill-specific (script flags, exit codes, provenance comments, envsubst workflow). However, the multi-line prose description of discover.sh's JSON output shape and the 20-row CRD table (whose controller/kind info partially duplicates flux-api-summary.md) are minor instances of content that could be trimmed or relocated. This fits anchor 4 (efficient with minor over-explanation) better than 5 (every token earns its place).

4 / 5

Actionability

Fully executable throughout: copy-paste-ready bash (the mktemp + validate.sh -b invocation), exact flags and exit-code semantics, concrete grep examples against the field-index naming convention, exact label strings (reconcile.fluxcd.io/watch: "Enabled"), and specific URLs. Covers the common cases the way the score-5 anchor describes.

5 / 5

Workflow Clarity

Six clearly sequenced phases with validation built in as a checkpoint (exit-code semantics, 'treat skipped as expected, not a failure') and an explicit feedback loop: when variable substitution fails schema checks, build a dotenv file and rerun with -E. The rubric's destructive/batch cap does not apply — all operations are read-only analysis where validation is the deliverable itself. Matches the score-5 anchor (explicit validation steps, error-recovery loops).

5 / 5

Progressive Disclosure

Verified against the actual bundle: all 6 references, 3 scripts, and 19 field-index files referenced from the body exist, and reference files cross-link only sibling files (one level deep, no nested chains). The body is a navigable overview with per-file 'when to load' signals, and scripts/schema data are appropriately separated. This matches the score-5 anchor; the inlined phase bullets and CRD table act as routing indexes rather than buried content.

5 / 5

Total

19

/

20

Passed

Description

100%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 model description: concrete and comprehensive on capabilities, explicit about scope boundaries, with a clear third-person 'what' and a trigger clause rich in natural synonyms. It closely matches the rubric's good overall examples.

DimensionReasoningScore

Specificity

The description lists multiple concrete, comprehensive actions — 'runs Kubernetes schema validation, detects deprecated Flux APIs, reviews RBAC/multi-tenancy/secrets management, and produces a prioritized GitOps report' — plus an explicit scope boundary ('scanning local repo files (not live clusters)'). This matches the score-5 anchor (multiple specific concrete actions, comprehensive coverage); score 4 would require a coverage gap, and none is evident.

5 / 5

Completeness

It explicitly answers both questions: a clear 'what' (four named capabilities with scope) and a concrete 'when' ('Use when users ask to audit, analyze, validate, review, or security-check a GitOps repo'). This matches the score-5 anchor and example structure; score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

The trigger clause covers comprehensive action synonyms — 'audit, analyze, validate, review, or security-check' — plus the natural domain terms users would say ('Flux CD', 'GitOps repo'). The domain has no meaningful file-extension trigger; nothing natural is missing, so this fits the score-5 anchor rather than the 'a few natural terms missing' anchor at 4.

5 / 5

Distinctiveness Conflict Risk

A clear Flux CD GitOps-repository niche with distinct triggers; the '(not live clusters)' parenthetical actively disambiguates it from live-cluster auditing skills, and triggers are constrained to 'GitOps repo' so generic code-review requests would not match. Voice is third person ('Use when users ask…'), so no voice penalty applies.

5 / 5

Total

20

/

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.

Validation — 14 / 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

Path

skills/gitops-repo-audit/SKILL.md

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.