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

80%

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 ./plugins/platform-skills/skills/gitops/SKILL.md

The canonical home for this skill is gitops in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 exceptionally actionable, well-sequenced troubleshooting and audit guide with executable commands and validation/rollback checkpoints. Its structural weakness is progressive disclosure: the bundle ships no reference or script files, so the body is a monolithic 460-line document whose only external link is broken and whose "bundled tooling" cannot be found.

Suggestions

Ship the referenced files or fix the links: create references/fluxcd-troubleshooting.md (or correct the ../references/ path), and either bundle examples/fluxcd/repo-audit or link to its canonical source so the audit scripts actually resolve.

Move the debug failure-mode tables and the Phase 4–5 audit checklists/grep recipes into one-level-deep reference files (e.g. references/debug-failure-modes.md, references/audit-checklists.md), keeping SKILL.md as a workflow overview.

Deduplicate the mode-selection logic: the Interactive Wizard Q1 and the Step 1 routing table say the same thing — keep one and reference it from the other.

DimensionReasoningScore

Conciseness

The ~460-line body is dense signal — executable command blocks and symptom→cause→fix tables of Flux/Argo-specific failure modes Claude does not know, with no conceptual padding. Minor trimming opportunities keep it at the 4 anchor rather than 5: the Interactive Wizard section duplicates Step 1's mode-selection table, the "Bundled tooling" paragraph is convoluted ("it is under the repository or Claude plugin root, or inside this skill's directory in a portable install"), and the vendoring-provenance blockquote is metadata rather than instruction.

4 / 5

Actionability

Fully executable throughout: complete `flux`/`kubectl`/`argocd` command blocks with jsonpath and label selectors (e.g. the HelmRelease trace's six labeled steps), grep recipes for security scanning, and failure tables covering the common cases. It is not a 4 because there are no pseudocode gaps — every instruction is copy-paste ready once placeholders like <name>/<namespace> are substituted.

5 / 5

Workflow Clarity

Both modes are explicitly sequenced: debug follows identify-layer → workflow → fix → five-section report → validation commands → rollback; audit is six numbered phases each with its script, version-verification prerequisites up front, checklists in Phase 4, and a defined report structure with severity ordering. Feedback loops (validation section, rollback section, "verify versions before proceeding") and checklists match the 5 anchor; the audit is declared read-only, and destructive-adjacent debug fixes have explicit validation and rollback steps.

5 / 5

Progressive Disclosure

The bundle contains no references/, scripts/, or assets/ directories, yet the body links to [references/fluxcd-troubleshooting.md](../references/fluxcd-troubleshooting.md) — a broken path pointing outside the skill — and instructs the reader to use a bundled "examples/fluxcd/repo-audit" directory that is not shipped. Scoring against the actual bundle structure, ~200+ lines of audit phase detail and failure-mode tables are inlined in a single monolithic SKILL.md where they clearly belong in separate reference files, matching the 2 anchor (content that belongs in separate files is inlined). It is not a 3 because the one reference that is signaled does not exist, making navigation actively misleading.

2 / 5

Total

16

/

20

Passed

Description

75%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-differentiated description that concretely enumerates both modes' capabilities and outputs. Its main weakness is the absence of explicit "Use when..." trigger guidance, which caps completeness, and the omission of the natural term "GitOps".

Suggestions

Add an explicit trigger clause, e.g. "Use when debugging Flux/Argo reconciliation errors, 'not reconciling' symptoms, or before merging/releasing a GitOps repository".

Include the term "GitOps" and common symptom phrases ("not reconciling", "drift", "out of sync") so the description matches how users naturally phrase these requests.

State the audience/trigger contexts for audit mode explicitly (pre-merge review, pre-release check, onboarding) rather than leaving them implied.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities across both modes: "five structured debug workflows for live clusters (installation, source, HelmRelease, Kustomization, ResourceSet) producing a five-section report" and "six-phase read-only repo analysis (discovery, validation, API compliance, best practices, security)" with a defined output format ("prioritised Critical/Warning/Info report"). Coverage is comprehensive and matches the 5 anchor; it is above the 4 anchor because no capability area is left out.

5 / 5

Completeness

The "what" is clearly and concretely stated for both modes, but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by "for live clusters" and "read-only repo analysis". This matches the 3 anchor (clear what, when missing or weakly implied) and the judging guideline caps completeness at 3 in this case; it is not a 4 because no explicit usage triggers are present.

3 / 5

Trigger Term Quality

Good natural-keyword coverage: "Flux CD", "Argo CD", "debug", "audit", "live clusters", "HelmRelease", "Kustomization", "repo analysis". Missing a few natural variations users would say — notably "GitOps" itself, "not reconciling", "drift", and "before merge/release" — so it fits the 4 anchor (good coverage, a few natural terms missing) rather than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche — Flux CD and Argo CD cluster debugging and repository auditing — with tool-specific terms (HelmRelease, Kustomization, ResourceSet, FluxInstance domain vocabulary) that would not collide with other skills. Minimal conflict risk, matching the 5 anchor; well above the 4 anchor's "minor overlap risk".

5 / 5

Total

17

/

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

plugins/platform-skills/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.