calculator

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

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

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

Quality

Content

73%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 well-structured and provides fully executable examples for a simple skill, but it is noticeably verbose because it explains basic arithmetic and order-of-operations concepts Claude already knows and carries version/date metadata that does not earn its tokens.

Suggestions

Remove the basic-arithmetic Quick Start examples ('15 + 27', '100 - 42') and the PEMDAS step-by-step walkthrough, since Claude already knows elementary arithmetic; keep only the operations table and any non-obvious conversions.

Drop the 'Version' and 'Last Updated' footer lines, or move any genuinely time-sensitive information into a clearly labeled deprecated/old-patterns section.

Trim the Tips section to only non-obvious guidance (e.g. division-by-zero behavior) and remove reminders about parentheses and modulo that duplicate the operations table.

Dimension	Reasoning	Score
Conciseness	The body spends significant space demonstrating basic arithmetic (e.g. 'result = 15 + 27 # Result: 42') and walking through PEMDAS step-by-step, concepts Claude already knows, and includes time-sensitive metadata ('Version: 1.0', 'Last Updated: October 25, 2025') outside any deprecated section.	2 / 5
Actionability	All examples are fully executable, copy-paste-ready Python snippets (e.g. 'feet = meters * 3.28084') covering the common arithmetic and unit-conversion cases.	5 / 5
Workflow Clarity	This is a simple single-purpose skill with an unambiguous action (perform a calculation) and no destructive or batch operations, so the simple-skill exception applies and the single action is clearly unambiguous.	5 / 5
Progressive Disclosure	Content is well-organized into clear sections (Overview, Quick Start, Supported Operations, Complex Expressions, Unit Conversions, Tips) with no nested references, and a single self-contained file is appropriate for this skill, though it exceeds the under-50-line simple-skill threshold so it does not fully hit the top anchor.	4 / 5
	Total	16 / 20 Passed

Description

80%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, well-structured description that explicitly covers both capabilities and trigger conditions with concrete operations. Its main weakness is the generic 'working with numbers' trigger, which raises overlap risk with adjacent skills.

Suggestions

Tighten the 'when' clause by dropping the overly broad 'working with numbers' in favor of more distinctive triggers like 'when the user asks for arithmetic results or unit conversions'.

Consider mentioning the extended operations (modulo, exponent) found in the body so the description's capability list matches the actual skill coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and enumerates four concrete operations ('addition, subtraction, multiplication, division') plus unit conversion, listing several specific actions with only minor gaps (modulo/exponent from the body are not surfaced in the description).	4 / 5
Completeness	Explicitly answers both 'what' ('Simple calculator for basic arithmetic operations...') and 'when' ('Use when performing calculations, converting units, or working with numbers') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Includes natural user-facing phrases ('performing calculations, converting units, or working with numbers') that a user would plausibly say, though a few common synonyms or variation phrases are missing.	4 / 5
Distinctiveness Conflict Risk	The 'calculator for basic arithmetic' niche is somewhat specific, but the broad trigger 'working with numbers' and 'converting units' could overlap with general math or unit-conversion skills.	3 / 5
	Total	16 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: 93ed392

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.