CtrlK
BlogDocsLog inGet started
Tessl Logo

fmt

Run `make fmt` to check the code format.

78

1.69x
Quality

68%

Does it follow best practices?

Impact

95%

1.69x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/fmt/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, single-purpose skill that exemplifies token efficiency: one command, what it covers, how to fix the most likely failures, and a re-run loop. Its main defects are the hard-coded personal absolute path and fix guidance that covers only one of the three checked categories.

Suggestions

Replace the hard-coded path 'cd /Users/paul.masurel/git/quickwit/quickwit' with a portable instruction, e.g. 'cd <repo-root>/quickwit && make fmt'.

Add one-line fix guidance for the other two check categories (e.g. run 'cargo fmt' / restore the license header template) so every failure mode in the check list has a remedy.

DimensionReasoningScore

Conciseness

The body is 17 lean lines with zero padding: 'Run `make fmt` from the `quickwit/` subdirectory', a three-item list of what the command checks, and fix bullets. Every token carries information Claude would not already know (the make target, what it covers, the repo's log format policy).

5 / 5

Actionability

The command and fix steps are concrete and executable ('Making the first character lowercase', 'Removing trailing punctuation'), but the example hard-codes a user-specific absolute path 'cd /Users/paul.masurel/git/quickwit/quickwit' instead of a portable relative path, so it is not copy-paste ready outside that one machine. That plus no fix guidance for the rustfmt and license-header categories keeps it just below fully executable.

4 / 5

Workflow Clarity

The sequence is clear and closes with an explicit feedback loop ('Fix any issues found and re-run until clean'), and the check command itself is the validation checkpoint. However, of the three listed check categories only log format issues get fix steps — what to do about 'Rust code formatting' or 'License headers' failures is left implicit, a minor gap.

4 / 5

Progressive Disclosure

Under the rubric's simple-skill exception (<50 lines, single task, no external files needed), the well-organized command block, numbered check list, and bulleted fix steps earn full credit; no bundle files exist and none are needed, so there are no buried or nested references.

5 / 5

Total

18

/

20

Passed

Description

50%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 concise and names a real, concrete action, but it is a bare one-liner: it omits when to use the skill, what the check actually covers, and the natural vocabulary (formatting, lint, style) users would employ. It scores uniformly at the rubric midpoint across all four dimensions.

Suggestions

Add explicit trigger guidance, e.g. 'Use when asked to check code formatting, license headers, or log message style in the quickwit repo.'

List what the check covers ('Rust formatting, license headers, and log message style') so the description matches the body's coverage and specificity.

Include natural synonyms users would say — 'formatting', 'lint', 'style', 'rustfmt' — to improve trigger-term coverage.

DimensionReasoningScore

Specificity

It names one concrete action ('Run `make fmt` to check the code format') but stops there — the body shows the command covers Rust formatting, license headers, and log format policy, none of which the description mentions. This matches anchor 3 ('1-2 concrete actions, but not comprehensive'), not anchor 4 which requires several listed actions.

3 / 5

Completeness

The 'what' is clear (run make fmt to check formatting) but there is no 'when' clause at all — no 'Use when...' or equivalent trigger guidance — which per the judging guidelines caps completeness at 3. Anchor 4 requires both what and when present.

3 / 5

Trigger Term Quality

'make fmt' and 'code format' are relevant keywords a user in this repo might say, but common variations and synonyms are missing: 'formatting', 'lint', 'style', 'rustfmt', 'license headers'. This sits at anchor 3 ('some relevant keywords but missing common variations'), above anchor 2 whose bar is purely generic terms like 'works with files'.

3 / 5

Distinctiveness Conflict Risk

'make fmt' is a project-specific target, but 'check the code format' is broad and would overlap with any general formatting, linting, or style skill, and the description gives no repo/language context to disambiguate. Anchor 3 ('somewhat specific but could still overlap with similar skills') fits better than anchor 4's 'minor overlap risk'.

3 / 5

Total

12

/

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
quickwit-oss/quickwit
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.