CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

calculator

Simple calculator for basic arithmetic operations (addition, subtraction, multiplication, division). Use when performing calculations, converting units, or working with numbers.

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 ./skills/skill-builder-generic/examples/calculator-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

66%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.

Well-organized and fully executable, but the token budget is spent almost entirely on arithmetic, PEMDAS, and unit-conversion formulas Claude already knows, so few tokens earn their place. As a simple single-purpose skill its workflow and structure are clear; the main costs are redundant examples and a version-dated metadata footer.

Suggestions

Remove or drastically shrink the basic-operation examples ('result = 15 + 27 # Result: 42') and redirect the token budget to genuinely non-obvious behavior: float precision pitfalls, '//' integer vs '/' true division semantics, and how to detect or handle division-by-zero before it raises.

Replace generic tips ('Use parentheses to control order of operations', 'Use % for remainder') with non-obvious guidance, and demonstrate handling the division-by-zero error the tips merely mention.

Drop the trailing 'Version / Last Updated / Example Type' footer — time-sensitive metadata adds tokens without aiding task execution.

DimensionReasoningScore

Conciseness

Nearly every section restates arithmetic Claude already knows natively — 'result = 15 + 27 # Result: 42', the PEMDAS walkthrough ('Step 1: Parentheses: 10 + 5 = 15'), and tips like 'Use % for remainder (modulo)'. A version-dated footer ('Last Updated: October 25, 2025') adds time-sensitive metadata outside any deprecated section. This sits between anchors 1 and 2: the redundancy is document-wide rather than a few padded sections, but each section is brief and cleanly formatted rather than tutorial-prose padding.

2 / 5

Actionability

The Python snippets are executable and correct with expected outputs ('result = (10 + 5) * 2 ** 3 / 4', 'fahrenheit = (celsius * 9/5) + 32'), and the operations table gives concrete worked values. Minor gap: 'Division by zero returns error' is asserted but no handling is shown, keeping it short of copy-paste-ready full coverage.

4 / 5

Workflow Clarity

This is a simple single-task skill with no multi-step or fragile process, so the simple-skill exception applies: the single action (evaluate an arithmetic expression, optionally stepping through order of operations) is unambiguous, and sections progress cleanly from basic operations to complex expressions to unit conversions. No destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

The single-file body is well organized under clear headers ('## Quick Start', '## Supported Operations', '## Complex Expressions', '## Unit Conversions', '## Tips') with no dangling references, and nothing that belongs in a separate file is inlined. It falls short of anchor 5 because the ~100-line body exceeds the lean minimal-skill bar and the trailing 'Version / Last Updated / Example Type' footer adds navigational clutter.

4 / 5

Total

15

/

20

Passed

Description

71%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.

A clear, third-person description that explicitly answers both what (the four basic arithmetic operations) and when (performing calculations, converting units, working with numbers). Its main weaknesses are the broad 'working with numbers' trigger, which invites overlap with data-oriented skills, and missing synonyms and operations (modulo, exponent) for fuller coverage.

Suggestions

Narrow the trigger clause by replacing the generic 'working with numbers' with more distinctive phrasing (e.g., 'when the user asks to compute a value, do arithmetic, or convert units') to reduce overlap with data-analysis and spreadsheet skills.

Add the missing capabilities (modulo, exponent, order of operations) and common synonyms like 'math' or 'calculate' so trigger coverage matches what the skill actually supports.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'basic arithmetic operations (addition, subtraction, multiplication, division)' — which matches 'several specific actions; minor gaps'. It is not 5 because modulo, exponent, and complex-expression support documented in the body are omitted, and not 3 because more than 1-2 actions are explicitly enumerated.

4 / 5

Completeness

Both parts are explicitly present: what ('Simple calculator for basic arithmetic operations (addition, subtraction, multiplication, division)') and when ('Use when performing calculations, converting units, or working with numbers'). It is not 5 because 'working with numbers' is generic, leaving the when-clause short of the fully concrete trigger phrases in the top anchor.

4 / 5

Trigger Term Quality

'performing calculations', 'converting units', and the four operation names are natural phrases users would say, giving good keyword coverage. It falls short of anchor 5 because common synonyms and variations such as 'math', 'compute', or 'calculate' are missing.

4 / 5

Distinctiveness Conflict Risk

The what-portion names a clear niche (a basic arithmetic calculator), but the trigger 'working with numbers' would match virtually any quantitative task — data analysis, spreadsheets, statistics — creating genuine overlap risk. This matches 'somewhat specific but could still overlap with similar skills' rather than 4, where overlap risk would be minor.

3 / 5

Total

15

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fernandezbaptiste/Skrillz

Path

skills/skill-builder-generic/examples/calculator-skill/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.