CtrlK
BlogDocsLog inGet started
Tessl Logo

naming

How to think about names in the Grida repo — not conventions, but what a name commits you to, reveals about the system, and costs to change. The central discipline is that a strict, honest name refuses to grow, and that refusal drives the repo's shape (flat modules, small agnostic packages, suffix siblings). Use when planning a new package, crate, module, directory, route group, or test corpus — the name comes first.

55

Quality

62%

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

Quality

Content

50%

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 thoughtful, well-structured naming treatise with concrete heuristics and examples, but it is verbose and conceptual rather than lean and step-wise, and it points to a cases.md file that is not present in the bundle. All dimensions land at the middle anchor.

Suggestions

Provide the referenced cases.md (or remove the dangling link) so the 'See cases.md for concrete tables and the grandfathered short-name list' pointer resolves to a real file.

Tighten the conceptual prose: collapse the philosophical asides into the actionable rules so each section leads with the decision a reader must make (flatten / rename / extract / nest).

Add a short, numbered 'when planning a name' decision flow with the diff test as an explicit validation checkpoint so the guidance reads as a sequenced workflow rather than observations.

DimensionReasoningScore

Conciseness

The body correctly treats vanilla conventions as table stakes ("assume them") and avoids explaining basics Claude knows, but it is a long conceptual essay ("A codebase where neither test passes easily has a naming problem dressed up as an architecture problem") with substantial philosophical elaboration that could be tightened, matching 'mostly efficient but could be tightened' rather than a lean every-token-earns-its-place level.

2 / 3

Actionability

It provides concrete decision rules and examples (the diff test, the terseness test "would adding any peer to this parent make the terse name ambiguous?", suffix rules, painter.rs sibling examples), but much of the guidance is diagnostic/observational framing about what names 'reveal' and 'cost' rather than directly executable steps, placing it between 'some concrete guidance' and fully instructive.

2 / 3

Workflow Clarity

The content is organized into clearly named sections and offers a verification signal via the diff test ("Remove it and the compiler or test suite will tell you"), but this is a set of principles rather than a sequenced multi-step workflow with explicit checkpoints, so it does not reach the clear-sequence-with-validation level.

2 / 3

Progressive Disclosure

Section structure and a 'The short version' summary give reasonable in-file organization, and the single reference to [cases.md](cases.md) is one level deep and clearly signaled, but no cases.md bundle file actually exists in references/scripts/assets, so the reference dangles, and the body is a long monolithic essay that could itself be split.

2 / 3

Total

8

/

12

Passed

Description

75%

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 well-formed with an explicit Use-when clause and a distinctive, well-scoped niche. Its main weakness is that the capability framing is conceptual ('how to think') rather than a crisp list of concrete actions, and the trigger terms are somewhat specialized to the Grida/Rust audience.

Suggestions

Lead the description with the concrete action the skill performs (e.g., 'Apply a naming discipline to decide whether to flatten, rename, or extract when planning...') so the capability reads as specific actions rather than 'how to think'.

Add a few broader trigger phrasings a user would naturally say (e.g., 'naming a new module', 'deciding a package name', 'when a name feels hard to pick') alongside the specialized artifact list.

DimensionReasoningScore

Specificity

Quotes like "what a name commits you to, reveals about the system, and costs to change" and "planning a new package, crate, module, directory, route group, or test corpus" name the domain and trigger contexts, but the core actions are conceptual ("think about", "plan") rather than a list of concrete operations, matching the 'names domain and some actions' anchor rather than the multiple-concrete-actions level.

2 / 3

Completeness

It explicitly states what the skill does ("How to think about names in the Grida repo... a strict, honest name refuses to grow") and gives an explicit "Use when planning a new package, crate, module, directory, route group, or test corpus" trigger, clearly answering both what and when with explicit triggers.

3 / 3

Trigger Term Quality

The "Use when planning a new package, crate, module, directory, route group, or test corpus" clause gives several relevant, fairly natural terms, but the mix leans on specialized jargon (crate, route group, test corpus) and is missing common variations a general user might say, so it sits at 'some relevant keywords but missing common variations' rather than full coverage.

2 / 3

Distinctiveness Conflict Risk

The scope is tightly bound to "names in the Grida repo" with distinct triggers around planning specific artifact types, making it a clear niche unlikely to fire for unrelated skills.

3 / 3

Total

10

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
gridaco/grida
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.