CtrlK
BlogDocsLog inGet started
Tessl Logo

fmt

Run `make fmt` to check the code format.

67

1.69x
Quality

52%

Does it follow best practices?

Impact

95%

1.69x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/fmt/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

17%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is extremely terse, providing only a single command and a brief purpose statement. It lacks a 'Use when...' clause, natural trigger terms users would say, and any elaboration on the scope or context of the skill. It would be very difficult for Claude to reliably select this skill from a pool of alternatives.

Suggestions

Add a 'Use when...' clause specifying triggers like 'when the user asks to format code, check formatting, run the formatter, or fix code style'.

Include natural trigger terms users would say, such as 'format', 'code style', 'formatting check', 'lint', 'auto-format'.

Expand the 'what' to describe what `make fmt` does in more detail, e.g., 'Runs the project's code formatter via `make fmt` to check and enforce consistent code style across the codebase.'

DimensionReasoningScore

Specificity

It names a concrete action ('Run `make fmt`') and its purpose ('check the code format'), but describes only a single action with no additional detail about what this entails or what it covers.

2 / 3

Completeness

It partially answers 'what' (run make fmt to check format) but completely lacks any 'when' guidance or explicit trigger clause. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also minimal, so this scores a 1.

1 / 3

Trigger Term Quality

The description contains 'make fmt', 'code format' but lacks natural user-facing trigger terms. Users might say 'format code', 'linting', 'style check', 'formatting', none of which are present. The terms used are narrow and technical.

1 / 3

Distinctiveness Conflict Risk

The mention of `make fmt` is somewhat specific to a particular build system command, which reduces conflict risk slightly, but 'check the code format' is generic enough to overlap with linting, style-checking, or other formatting skills.

2 / 3

Total

6

/

12

Passed

Implementation

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-crafted, concise skill that provides actionable guidance for running format checks. It efficiently communicates the exact command, what it validates, and how to fix common issues. The only minor weakness is that the feedback loop (fix and re-run) could be more explicitly structured as a numbered workflow with a validation checkpoint.

DimensionReasoningScore

Conciseness

The skill is lean and efficient. Every line serves a purpose—command, what it checks, and how to fix common issues. No unnecessary explanations of what formatting is or how make works.

3 / 3

Actionability

Provides a concrete, copy-paste ready command with the exact path, lists the specific checks performed, and gives specific fix instructions (lowercase first character, remove trailing punctuation).

3 / 3

Workflow Clarity

The workflow mentions 'fix any issues found and re-run until clean' which implies a feedback loop, but it's not explicitly structured as a validation checkpoint. For a formatting check that can modify code, a more explicit validate-fix-revalidate sequence would be stronger.

2 / 3

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines. The content is well-organized with a clear command, numbered list of checks, and fix instructions. No external references are needed.

3 / 3

Total

11

/

12

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.

Validation11 / 11 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.