CtrlK
BlogDocsLog inGet started
Tessl Logo

flox-publish

Use for publishing user packages to flox for use in Flox environments. Use for package distribution and sharing of builds defined in a flox environment.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./flox-plugin/skills/flox-publish/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 thorough, highly actionable publishing guide with executable examples and well-sequenced workflows including pre-publish validation. It is let down by command repetition across sections and a monolithic single-file structure that resists progressive disclosure.

Suggestions

De-duplicate the `flox publish` command examples: present them once in 'Core Commands' and reference that section elsewhere instead of restating.

Move the CI examples, versioning strategies, and Nix-expression build section into separate reference files (e.g. references/ci.md, references/versioning.md) and link to them from SKILL.md to improve progressive disclosure.

Add an explicit post-publish verification checkpoint to the main workflow (e.g. run `flox show <org>/<pkg>` or `flox search <pkg>` to confirm availability).

DimensionReasoningScore

Conciseness

The body is mostly useful domain reference, but the core `flox publish` commands are restated across 'Core Commands', 'Publishing Commands', and multiple workflow sections, and several explanations could be tightened without losing clarity.

3 / 5

Actionability

Copy-paste-ready bash, TOML, and YAML examples throughout cover the common cases — single/all/org/personal publish, versioning strategies, CI pipelines, and local testing — with concrete executable commands.

5 / 5

Workflow Clarity

Clear sequenced phases (dev → build/publish → runtime) and numbered steps with a prerequisites checklist and a test-before-publish feedback loop; validation is present, though explicit post-publish verification is only implied rather than stated as a checkpoint.

4 / 5

Progressive Disclosure

Section headers are clear and logically ordered, but this is a ~500-line monolith with no bundle files — CI examples, versioning strategies, and Nix-expression builds are inlined content that would be better split into one-level-deep reference files.

3 / 5

Total

15

/

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.

The description is clear and trigger-explicit, covering the what and when of flox package publishing with good natural keywords. Its main weakness is redundancy — the two sentences restate the same publish/distribute/share operation rather than broadening capability coverage.

Suggestions

Collapse the two repetitive 'Use for…' sentences into one, and use the freed space to add a distinguishing concrete action or trigger synonym (e.g., 'flox publish', 'catalog', 'FloxHub').

Add a contrast clause to reduce conflict with flox-sharing, e.g. 'for publishing built binaries/artifacts, not for sharing environment definitions'.

DimensionReasoningScore

Specificity

Names the flox domain and concrete actions ("publishing user packages", "package distribution", "sharing of builds"), but these are largely redundant facets of a single publish operation rather than a comprehensive, distinct set of actions.

3 / 5

Completeness

Explicitly answers both what (publish/distribute/share builds to flox) and when via a repeated "Use for…" trigger clause; the trigger is explicit but slightly redundant rather than crisp and concrete, so it sits below a 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage ("publishing", "packages", "distribution", "sharing of builds", "flox") that a user would plausibly say; a few synonyms or file/extension terms are missing, keeping it just below comprehensive.

4 / 5

Distinctiveness Conflict Risk

Targets a clear flox-package-publishing niche with distinct triggers; minor overlap risk with the sibling flox-sharing skill, which the body itself distinguishes (binaries vs. environment definitions).

4 / 5

Total

15

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
flox/flox-agentic
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.