CtrlK
BlogDocsLog inGet started
Tessl Logo

evilissimo/naming-things

Reviews and improves **names** in code — variables, functions, classes, modules, parameters — for clarity, intent, and consistency with language/team conventions. Triggers when asked to review names, rename things, improve code readability, clean up confusing code, or when examining code with generic/vague names like "data", "info", "manager", "temp", "util". Does NOT trigger for general code review unrelated to naming, architecture design, debugging, or performance optimization. Identifies naming anti-patterns (generic names, misleading names, type-encoding, abbreviations), suggests role-based names that reveal intent, checks consistency with project/domain vocabulary, and flags misalignment with language culture.

91

1.05x
Quality

90%

Does it follow best practices?

Impact

94%

1.05x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Content

77%

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-structured naming skill with strong actionability — the before/after examples, anti-pattern table, and function prefix guide are all highly practical. The workflow is clearly sequenced with good validation steps. Main weaknesses are slightly verbose content that could be tightened, and referenced language files that don't exist in the bundle.

Suggestions

Provide the referenced `references/<language>.md` files or remove the references to avoid broken links

Trim the before/after examples to be more concise — one shorter example per language would suffice, or move extended examples to a separate EXAMPLES.md file

DimensionReasoningScore

Conciseness

The content is mostly efficient with useful tables and examples, but some sections are slightly verbose — e.g., the principles list in Step 5 includes guidance Claude already knows (pronounceability, searchability), and the before/after examples are lengthy. The anti-pattern table is well-structured but could be tighter.

2 / 3

Actionability

The skill provides concrete before/after code examples in multiple languages, a clear function prefix guide, specific validation steps, and executable rename workflow. The guidance is specific and directly applicable rather than abstract.

3 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced with logical progression from identification through execution. Step 6 provides explicit validation checkpoints (read aloud, check conflicts, grep-ability, new team member test), and Step 7 includes a feedback loop for fixing related names and handling blockers.

3 / 3

Progressive Disclosure

The skill references language-specific files in `references/<language>.md` which is good progressive disclosure structure, but no bundle files were provided, meaning those references don't actually exist. The main content is also fairly long and could benefit from splitting the examples or the prefix guide into separate reference files.

2 / 3

Total

10

/

12

Passed

Description

100%

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 is an excellent skill description that clearly defines a narrow, well-scoped domain (code naming), provides rich trigger terms including concrete examples of problematic names, and explicitly delineates boundaries with a 'Does NOT trigger' clause. The description is comprehensive yet focused, making it easy for Claude to distinguish this skill from general code review or refactoring skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: identifies naming anti-patterns, suggests role-based names that reveal intent, checks consistency with project/domain vocabulary, flags misalignment with language culture. Also enumerates specific targets (variables, functions, classes, modules, parameters).

3 / 3

Completeness

Clearly answers both 'what' (reviews and improves names in code, identifies anti-patterns, suggests role-based names, checks consistency) and 'when' (explicit trigger clause with 'Triggers when...' and a 'Does NOT trigger' exclusion clause).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: 'review names', 'rename things', 'improve code readability', 'clean up confusing code', and concrete examples of problematic names like 'data', 'info', 'manager', 'temp', 'util'. Also includes negative triggers to reduce false matches.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche (code naming specifically), and explicitly excludes overlapping domains like general code review, architecture design, debugging, and performance optimization, which greatly reduces conflict risk.

3 / 3

Total

12

/

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.

Reviewed

Table of Contents