CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gitops-knowledge

Flux CD and Flux Operator expert — answers questions and generates schema-validated YAML for all Flux CRDs (not repo auditing or live cluster debugging). Use when users ask about Flux concepts, want manifests for HelmRelease, Kustomization, GitRepository, OCIRepository, ResourceSet, FluxInstance, or any Flux resource. When user needs guidance on GitOps repository structure, bootstrap Flux with Terraform, multi-tenancy, OCI-based delivery, image tag automation, drift detection, preview environments, monorepo app delivery, running migration Jobs before or after a deployment, notifications, or the Flux Web UI and MCP Server.

75

Quality

94%

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.

The skill body is an excellent knowledge-base overview: actionable canonical YAML patterns, unambiguous decision trees, and a schema-validation workflow with an explicit fix-and-retry loop. Bundle references are well organized and all real. Only conciseness keeps it from top marks, due to a small preamble and minor repetition across the table, decision trees, and Common Mistakes sections.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely Flux-specific (exact apiVersions, field-index grep commands, annotation names) with little padding, but the "You are an expert on Flux CD..." preamble and some overlap between the CRD table, decision trees, and Common Mistakes could be trimmed. Efficient with minor instances of over-explanation — anchor 4 rather than 5.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste-ready YAML patterns with correct apiVersion/kind pairs, a concrete grep example for the field indexes (`grep '^spec\.chart\.' assets/schemas/helmrelease-helm-v2.fields.txt`), specific annotations (`fluxcd.controlplane.io/force: enabled`), and exact CLI commands. Covers the common cases comprehensively.

5 / 5

Workflow Clarity

Multi-step workflows are clearly sequenced with explicit validation and a feedback loop: inventory layout with `flux schema discover`, verify fields against the schema index before generating, then "validate them with `flux schema validate` — fix and re-run until clean," including a fallback when tools are missing. Decision trees make selection unambiguous. Meets the anchor-5 feedback-loop and checkpoint bar.

5 / 5

Progressive Disclosure

The body is a genuine overview: a CRD table mapping every kind to its reference file, a topic table doing the same, and field indexes in assets/schemas/ — all one level deep, clearly signaled, and every referenced path verified to exist (16 references/*.md, 19 assets/schemas/*.fields.txt). Easy navigation with content appropriately split.

5 / 5

Total

19

/

20

Passed

Description

95%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.

The description is strong: it states concrete capabilities, provides explicit 'Use when' triggers with comprehensive natural terminology, and delimits scope with clear exclusions. Its only weakness is that the capability statement relies on two core verbs (answer questions, generate YAML) with breadth expressed through enumeration rather than a wider set of distinct actions.

DimensionReasoningScore

Specificity

"answers questions and generates schema-validated YAML for all Flux CRDs" names two concrete actions and comprehensively enumerates targets (HelmRelease, Kustomization, GitRepository, ResourceSet, FluxInstance, image automation, monorepo delivery). It lists several specifics with only minor gaps, matching the anchor-4 example better than anchor 5, which expects multiple distinct concrete action verbs rather than two verbs plus an enumeration.

4 / 5

Completeness

Explicitly answers both questions: what ("answers questions and generates schema-validated YAML for all Flux CRDs") and when ("Use when users ask about Flux concepts..." / "When user needs guidance on...") with concrete trigger phrases and even explicit exclusions ("not repo auditing or live cluster debugging"). Clearly matches the anchor-5 example structure.

5 / 5

Trigger Term Quality

Comprehensive natural trigger terms users would actually say: Flux, GitOps, manifests, multi-tenancy, drift detection, bootstrap Flux with Terraform, image tag automation, preview environments, monorepo app delivery, migration Jobs, notifications, Web UI, MCP Server — plus the concrete resource kinds. Not score 4 because coverage includes both everyday phrasings and the specific CRD names a user would mention.

5 / 5

Distinctiveness Conflict Risk

A clear Flux CD/Flux Operator niche with distinct triggers (specific CRD kinds, GitOps delivery topics) and an explicit scope boundary ("not repo auditing or live cluster debugging"), giving minimal conflict risk with other skills. Not score 4 because the domain and exclusions make overlap risk negligible rather than minor.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

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

Warning

Total

15

/

16

Passed

Repository

fluxcd/agent-skills

Path

skills/gitops-knowledge/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.