CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

preflight

Load to run, tune, or debug preflight.

Quality

68%

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/preflight/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

90%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 body is an exemplary lean overview: executable commands for all three scopes, a crisp remediation rule, and well-targeted delegation to --help and references/lanes.md. The only defects are the implicit re-run loop and the dangling README.md § Wiring reference.

DimensionReasoningScore

Conciseness

The ~15-line body contains only instructions, three commands, one dense policy line ("Fix what a finding reports; never widen a lane's exclusions to clear it."), and pointers that delegate rather than restate ("Lanes, scopes, settings, output and exit codes are in `preflight --help`."), with no concept explanations. Every token earns its place, matching the anchor 5 example of lean, competence-assuming content.

5 / 5

Actionability

The three copy-paste-ready commands cover all common invocation modes, each annotated with what it scans ("--staged # staged changes (pre-commit)", "--all # every tracked file, every line"), plus a concrete remediation rule. Fully executable and covering the common cases per anchor 5; not 4 because there is no meaningful gap in the executable guidance.

5 / 5

Workflow Clarity

The sequence is explicit ("Run preflight in the validate step, before the project's own validation command") with a clear remediation policy (fix findings, never widen exclusions), but the fix-then-re-run feedback loop is only implicit rather than stated as a checkpoint. Anchor 4 ("Clear sequence with most checkpoints present; minor validation gaps"); not 5 because no explicit re-run/until-clean checkpoint is given, and not 3 because positioning and remediation are both stated.

4 / 5

Progressive Disclosure

A lean overview delegating detail to `preflight --help`, the real one-level-deep [references/lanes.md](references/lanes.md) (signaled with the exact topics it covers), and [README.md](README.md) for hook/CI wiring — but README.md is not present in the bundle, so that link dangles. Anchor 4 ("Good structure; most content appropriately placed; references mostly clear; minor organization gaps"); not 5 because of the broken README.md reference, and not 3 because the structure and signaling are otherwise strong.

4 / 5

Total

18

/

20

Passed

Description

36%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 relies entirely on the skill's own name as content: it says the skill can run, tune, or debug "preflight" but never says what preflight is or does. The concrete capability list exists only in the frontmatter "summary" field, leaving the description vague on both what and when.

Suggestions

Move the capability content from the frontmatter "summary" field into "description", e.g. "Runs diff-scoped fail-only checks over one change: shell safety, unwired suites, scratch directories, temp paths, dead path citations, applied migrations, and data syntax."

Add an explicit trigger clause such as "Use when validating a change before commit or merge, or when tuning or debugging a preflight finding."

Include natural trigger phrases users would say without knowing the tool's name, e.g. "before committing", "staged changes", "check the diff".

DimensionReasoningScore

Specificity

"Load to run, tune, or debug preflight." names the domain (preflight) but the actions "run, tune, or debug" are generic verbs applicable to any tool, and no concrete capability is described. This matches anchor 2 ("Names the domain but actions are minimal or generic"); not 3 because not even one capability-specific action (what preflight checks) is stated, and not 1 because a domain and verbs are named.

2 / 5

Completeness

There is no "Use when..." clause or explicit trigger guidance (which caps completeness at 3 per the guidelines), and the "what" is vague: what preflight actually does (diff-scoped fail-only checks) is stated only in the separate "summary" field, not in the description. Anchor 2 ("Has a vague 'what' and no 'when'") fits best; not 3 because the "what" is not clear, and not 1 because a named domain and actions are present.

2 / 5

Trigger Term Quality

The keywords "run", "tune", "debug", and "preflight" capture how a user who already knows the tool would invoke it, but no natural functional phrases a user would say without knowing the name (e.g. "check my changes before committing", "lint the diff") appear. Some relevant keywords but missing common variations, per anchor 3; not 4 because the natural functional phrasings are entirely absent.

3 / 5

Distinctiveness Conflict Risk

"Load to run, tune, or debug preflight" is anchored to a distinct tool name, so it is unlikely to trigger for unrelated skills, but with zero domain or function content it is indistinguishable from any other named-tool skill and "run/tune/debug" are fully generic. Anchor 3 ("Somewhat specific but could still overlap with similar skills"); not 4 because nothing beyond the name separates it from other tool-operating skills.

3 / 5

Total

10

/

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

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

vanillagreencom/kendex

Path

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