CtrlK
BlogDocsLog inGet started
Tessl Logo

clean-code

Pragmatic coding standards - concise, direct, no over-engineering, no unnecessary comments

53

Quality

42%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agent/skills/clean-code/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

0%

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 fails on all dimensions by stating abstract coding philosophy rather than concrete capabilities. It provides no actionable information about what the skill does, when to use it, or how to distinguish it from other coding-related skills. The description reads more like a style preference than a functional skill description.

Suggestions

Add specific concrete actions the skill performs (e.g., 'Reviews code for simplicity, removes redundant comments, refactors verbose implementations')

Include a 'Use when...' clause with natural trigger terms (e.g., 'Use when reviewing code, refactoring, or when user asks for cleaner/simpler code')

Specify the domain or context to reduce conflict risk (e.g., 'Applies to Python/JavaScript code reviews' or 'For production codebase maintenance')

DimensionReasoningScore

Specificity

The description uses vague, abstract language like 'pragmatic coding standards' and 'no over-engineering' without listing any concrete actions Claude would perform. It describes qualities/principles rather than specific capabilities.

1 / 3

Completeness

Missing both clear 'what' (no concrete actions) and 'when' (no explicit trigger guidance or 'Use when...' clause). The description only states philosophical principles without explaining what the skill does or when to use it.

1 / 3

Trigger Term Quality

Contains no natural keywords users would say when requesting help. Terms like 'pragmatic' and 'over-engineering' are abstract concepts, not trigger phrases like 'write code', 'refactor', or 'code review'.

1 / 3

Distinctiveness Conflict Risk

Extremely generic - 'coding standards' could apply to virtually any programming-related skill. No specific domain, language, or task type is identified to distinguish it from other coding skills.

1 / 3

Total

4

/

12

Passed

Implementation

85%

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

This skill excels at conciseness through effective use of tables and avoids explaining concepts Claude already knows. The workflow sections provide excellent validation checkpoints. However, it could benefit from more executable code examples rather than conceptual rules, particularly in the anti-patterns section where before/after code snippets would be more actionable.

Suggestions

Add executable before/after code examples in the Anti-Patterns section to make fixes copy-paste ready

Include a concrete code example demonstrating guard clauses vs deep nesting transformation

DimensionReasoningScore

Conciseness

Extremely lean and efficient use of tables to convey rules. No unnecessary explanations of concepts Claude already knows. Every section earns its place with actionable guidance.

3 / 3

Actionability

Provides clear rules and anti-patterns in table format, but lacks executable code examples. The one code snippet shown is a conceptual diagram rather than runnable code. Rules are specific but not copy-paste ready.

2 / 3

Workflow Clarity

Clear multi-step workflows for editing files and self-checking before completion. The 'Before Editing ANY File' and 'Self-Check Before Completing' sections provide explicit validation checkpoints with clear sequencing.

3 / 3

Progressive Disclosure

Well-structured overview with clear navigation to sub-skills via one-level-deep references. Knowledge modules are clearly signaled with links to separate files for detailed content.

3 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
Dokhacgiakhoa/antigravity-ide
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.