CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flux-controller-minor-releases

Run the upstream Flux controller minor release procedure for helm-controller, image-automation-controller, image-reflector-controller, kustomize-controller, notification-controller, source-controller, and source-watcher. Use when cutting a new controller minor release (vX.Y.0): creating the release series branch, drafting the minor changelog, tagging, merging the release branch back to main, and adding the backport label.

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

88%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 highly actionable, rigorously sequenced release runbook: every step carries executable git/gh commands, explicit validation gates, and rationale for fragile orderings. The only costs are token-level repetition between the Important rules, Critical Checks, and Useful Local Queries sections, and a monolithic single-file layout where the changelog and dependent-bump guides could live in reference files.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no explanations of concepts Claude already knows, but there is real repetition: 'git fetch --all --tags --prune', 'push the api/ tag first', and 'open the label PR last' each appear both in the flow and again in Critical Checks, and Useful Local Queries repeats changelog-section commands verbatim.

4 / 5

Actionability

Commands are copy-paste ready throughout — 'git switch -c release/vX.Y.x main', 'git tag -s -m "vX.Y.0" vX.Y.0', 'gh pr view <n> -R fluxcd/<repo> --json number,baseRefName,state,mergedAt,title', the approval-poll loop, and the exact labels.yaml snippet — with the version placeholders explicitly designated for adaptation.

5 / 5

Workflow Clarity

An 11-step numbered sequence with explicit validation checkpoints (confirm version refs on the merge commit before tagging, watch the release workflow to conclusion, CI green plus maintainer approval before each merge), feedback loops for review fixes and error recovery, ordering rationale (api tag first, label PR last with a 'Why last' explanation), and a closing Critical Checks checklist.

5 / 5

Progressive Disclosure

No bundle files exist; the skill is a single well-sectioned file with one-level structure and no dead-end references. At roughly 290 lines, though, the changelog-building and dependent-controller API-bump sections are substantial bodies that could be split into reference files — minor organization gaps rather than an ideal split.

4 / 5

Total

18

/

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 model description: it states what the skill does by enumerating the concrete release steps and all seven controllers, and gives an explicit version-pattern trigger for when to use it. The single weakness is a handful of missing natural synonyms for the trigger phrasing.

DimensionReasoningScore

Specificity

It enumerates the complete concrete procedure — 'creating the release series branch, drafting the minor changelog, tagging, merging the release branch back to main, and adding the backport label' — and names all seven supported controllers, matching the comprehensive-coverage anchor rather than the minor-gaps anchor below it.

5 / 5

Completeness

Both halves are explicit: the 'what' is the enumerated release procedure, and the 'when' is the concrete trigger 'Use when cutting a new controller minor release (vX.Y.0)' — exactly the shape of the anchor-5 example.

5 / 5

Trigger Term Quality

Natural trigger terms are strong — 'cutting a new controller minor release (vX.Y.0)', 'changelog', 'tagging', 'backport label' — but a few phrasings a user might equally say ('publish/ship a release', 'new version') are absent, so it sits just below the comprehensive-with-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (upstream Flux controller minor releases, named repos, vX.Y.0 pattern) with trigger phrases unlikely to fire for generic git, release, or changelog skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fluxcd/agent-skills

Path

internal/skills/flux-controller-minor-releases/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.