CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gitops

Flux CD and Argo CD — two modes. debug: five structured debug workflows for live clusters (installation, source, HelmRelease, Kustomization, ResourceSet) producing a five-section report. audit: six-phase read-only repo analysis (discovery, validation, API compliance, best practices, security) producing a prioritised Critical/Warning/Info report.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/gitops/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 unusually dense, expert-level body with copy-paste commands, explicit layered workflows, validation/rollback checkpoints, and read-only guards — excellent actionability and workflow clarity. The key defects are progressive disclosure: the referenced cheat-sheet and audit scripts do not exist in the bundle, and the failure-mode/checklist detail is inlined in a monolithic 460-line file rather than split into references.

Suggestions

Ship the referenced bundle files: create references/fluxcd-troubleshooting.md (fix the ../references path to a skill-relative references/ path) and include the examples/fluxcd/repo-audit scripts and README so the audit phases and the cheat-sheet link actually resolve.

Move the per-workflow symptom→cause→fix tables, the stable API-version table, and the Phase 4/5 checklists into one-level-deep reference files, keeping SKILL.md as a navigable overview with well-signaled links.

Resolve audit_dir deterministically (a concrete path relative to the skill root, plus a fallback the model can check) instead of "under the repository or Claude plugin root, or inside this skill's directory in a portable install".

DimensionReasoningScore

Conciseness

The body is dense and unpadded — it assumes GitOps competence ("You are a senior platform engineer specialising in GitOps") and goes straight to layers, commands, and symptom→cause→fix tables containing non-obvious operational detail ("SSH scp-style URLs (`git@host:repo`) are NOT supported", "layerSelector.mediaType: application/vnd.cncf.helm.chart.content.v1.tar+gzip"), matching anchor 4. It is not 5 because the ~460-line monolith inlines bulk detail (full failure-mode tables, the "Current stable API Versions" table, Phase 4/5 checklists) that belongs in reference files, and not 3 because nearly every line carries information Claude would not reliably know.

4 / 5

Actionability

Commands are copy-paste ready throughout — exact kubectl/flux invocations, jsonpath pipelines ("kubectl get kustomization -A -o jsonpath='{range .items[*]}...'"), ready greps, and a literal patch command ("kubectl patch fluxinstance flux --type=merge -p '{\"spec\":{\"suspend\":false}}'"). It falls short of anchor 5 because the entire audit mode hinges on bundled scripts whose location is left uncertain ("it is under the repository or Claude plugin root, or inside this skill's directory in a portable install") and which are not present in the bundle — a concrete gap beyond minor; it is well above anchor 3 because everything else is directly executable.

4 / 5

Workflow Clarity

Both modes have explicit sequences with validation and feedback loops: mode identification with an ambiguity fallback ("If the mode is ambiguous, ask"), a top-down dependency rule ("Follow the dependency chain top-down — do not skip layers"), then Fix → Report → Validation → Rollback with concrete validation commands ("flux reconcile kustomization <name> --with-source") and a defined five-section report; audit mode runs six sequenced phases with prerequisite version checks, a read-only guard ("Read-only — do not apply any changes"), checklists, and coverage-gap warnings ("do not treat a successful exit as validation of skipped resources") — matching anchor 5.

5 / 5

Progressive Disclosure

The bundle contains only SKILL.md — no references/, scripts/, or assets/ — yet the body links to "references/fluxcd-troubleshooting.md" (via an odd ../references path) and instructs "Use examples/fluxcd/repo-audit" with "$SCRIPTS/discover.sh", "$SCRIPTS/validate.sh", "$SCRIPTS/check-deprecated.sh" and a "bundled audit README", none of which exist, so those references are dangling. A ~460-line monolith also inlines content (per-workflow failure tables, checklists) that belongs in separate one-level-deep files, matching anchor 3 (structure present, references not resolvable, content that should be separate is inline). It is not 4 because missing bundle files behind half the skill's workflow is more than a minor organization gap, and not 2 because the single external reference is clearly signaled and in-body section structure is strong.

3 / 5

Total

16

/

20

Passed

Description

70%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 specific, well-scoped description that clearly separates the two modes and their outputs, in a distinctive niche. Its main weakness is the missing "Use when..." trigger guidance and the absence of common user phrasings like "GitOps" or "not reconciling".

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions GitOps, Flux, Argo CD, resources not reconciling, sync/health failures, or wants a pre-merge/pre-release repository health check."

Include natural synonyms users actually type — "GitOps", "not reconciling", "drift", "argocd app out of sync" — to strengthen trigger-term coverage.

State the primary action verbs more concretely (e.g. "traces failures across source → Kustomization → HelmRelease dependency chains") rather than naming workflow categories.

DimensionReasoningScore

Specificity

The description enumerates concrete scope per mode — "five structured debug workflows for live clusters (installation, source, HelmRelease, Kustomization, ResourceSet)" and "six-phase read-only repo analysis (discovery, validation, API compliance, best practices, security)" — which matches anchor 4 (several specific items, minor coverage gaps). It is below anchor 5 because the actual verbs are only "debug workflows" and "repo analysis" with the workflow/phase names as scope, not multiple distinct concrete actions like "extract text, fill forms, merge documents"; it is above anchor 3 because it far exceeds naming the domain plus 1-2 actions.

4 / 5

Completeness

The "what" is explicit and detailed for both modes ("producing a five-section report", "producing a prioritised Critical/Warning/Info report"), but there is no "Use when..." clause or equivalent trigger guidance, which caps this at 3 per the judging guideline. It is not 4 because the "when" is entirely absent rather than merely under-specified, and not 2 because the "what" is concrete and comprehensive.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "Flux CD and Argo CD", "debug", "live clusters", "audit", "repo" — good keyword coverage matching anchor 4. It falls short of anchor 5's comprehensive synonym coverage because common phrasings like "GitOps", "not reconciling", "sync failed", "drift", or "HelmRelease failing" are absent, while it is clearly above anchor 3 (only some relevant keywords).

4 / 5

Distinctiveness Conflict Risk

"Flux CD and Argo CD" names a clear niche with product-name triggers, and the two-mode framing (live-cluster debug vs read-only repo audit) is highly distinctive — minimal conflict risk with any other skill, matching anchor 5.

5 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

nitinjain999/platform-skills

Path

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