CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

justfile

Use when invoked as $justfile or when creating, editing, reviewing, or adding recipes to a justfile, Justfile, or *.just file.

Quality

75%

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 ./.agents/harness/adapters/antigravity/skills/justfile/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 a maximally lean delegation stub: one unambiguous instruction to load a shared skill, with no inline guidance, examples, or workflow. Token efficiency is excellent, but actionability and workflow clarity suffer because every task-specific detail lives in an external file outside the skill bundle.

Suggestions

Add a brief inline quick-start (e.g., a minimal recipe syntax example or the `just --list` command) so the skill provides actionable value even when the shared skill at ~/.agents/skills/justfile/SKILL.md is unavailable.

Summarize the key steps for the most common tasks (creating/editing/reviewing recipes) in the body, delegating only advanced detail to the shared skill, so the workflow sequence and any validation checkpoints are visible locally.

Include one line describing what the shared skill contains so readers can navigate without loading it blind.

DimensionReasoningScore

Conciseness

The body is two lines — a generation provenance comment and "Load and follow the shared skill at `~/.agents/skills/justfile/SKILL.md`." — with zero padding and no explanation of concepts Claude already knows; every token earns its place.

5 / 5

Actionability

The only guidance is a single high-level pointer to an external file; no task-specific steps, commands, or examples exist in the body itself. Not 1 because the pointer is a specific, executable instruction rather than vague description; not 3 because there is no partial concrete guidance — 100% of task guidance is delegated.

2 / 5

Workflow Clarity

The single delegation step ("Load and follow the shared skill") is unambiguous, but the skill's described scope (creating, editing, reviewing, adding recipes) shows no visible sequence or validation checkpoints — the entire workflow is implicit in an external file. Not 4-5 because the actual task workflow is absent rather than having only minor gaps; not 2 because the one instruction given is precise, not poorly defined.

3 / 5

Progressive Disclosure

There is exactly one clearly signaled, one-level-deep reference and nothing inlined that belongs elsewhere (no bundle files exist in references/, scripts/, or assets/). Not 5 because navigation depends entirely on an external path outside the bundle with no in-file overview of what it covers — a dead end if the shared skill is not installed; not 3 because the reference that exists is clean, unburied, and appropriately shallow.

4 / 5

Total

14

/

20

Passed

Description

78%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 strong: it has an explicit, specific 'Use when' clause with concrete file-type triggers (justfile, Justfile, *.just) and clearly scoped actions (create, edit, review, add recipes). Its main gaps are the lack of a standalone capability statement and missing trigger terms for the `just` command and running recipes.

DimensionReasoningScore

Specificity

"creating, editing, reviewing, or adding recipes to a justfile, Justfile, or *.just file" lists several concrete actions in a clearly named domain. It falls short of 5 because common justfile activities like running/executing recipes or working with `just` syntax are not covered, and exceeds 3 because more than 1-2 specific actions are explicitly stated.

4 / 5

Completeness

An explicit "Use when invoked as $justfile or when creating, editing, reviewing..." clause answers 'when' concretely, and the 'what' is directly readable from the listed actions. Not 5 because there is no standalone capability statement (the actions are grammatically embedded in the trigger clause); not 3 because the 'when' is explicit and detailed, not missing or weakly implied.

4 / 5

Trigger Term Quality

Natural triggers include "justfile", "Justfile", "*.just", and "recipes", covering synonyms and the file extension. Not 5 because users commonly refer to the `just` command itself (e.g. "run this with just") or to running recipes, and no such trigger term is present; not 3 because synonym and extension coverage is solid rather than partial.

4 / 5

Distinctiveness Conflict Risk

"justfile, Justfile, or *.just file" plus "$justfile" define a clear niche with distinct, file-type-specific triggers. Overlap risk with adjacent build-tool skills is minimal, matching the top anchor rather than the 'minor overlap' anchor at 4.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/skills/justfile/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.