CtrlK
BlogDocsLog inGet started
Tessl Logo

fitness-nutrition

Workout planning, macros, and body metrics via wger/USDA.

57

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./optional-skills/health/fitness-nutrition/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 a strong, highly executable skill document: exact API calls with pitfalls, ready-to-run snippets, and a verification section. Its main weaknesses are mild redundancy between Procedure and the Quick Reference table, bulk lookup tables inlined rather than moved to references, and one bundled script (nutrition_search.py) that is not linked from the main file.

Suggestions

Reference `scripts/nutrition_search.py` from the Nutrition Lookup section (or remove it) — it exists in the bundle but is undiscoverable from SKILL.md.

Move the category/muscle/equipment ID tables into `references/ID_TABLES.md` and keep only a pointer, trimming the main file's token load.

Collapse the Quick Reference table or the inline endpoint listings — they duplicate each other; keep one source of truth.

DimensionReasoningScore

Conciseness

The body is largely lean — no explanations of concepts Claude already knows, dense ID lookup tables explicitly justified as saving API calls ("so you don't need extra API calls"), and tight Pitfalls/Verification sections. It misses anchor 5 because of redundancy: the Quick Reference table repeats endpoints already shown in Procedure, and some Pitfall lines restate parameters already given inline.

4 / 5

Actionability

Every workflow ships copy-paste-ready curl + Python snippets with exact query parameters, the offline calculators have exact CLI invocations (e.g. `python scripts/body_calc.py tdee <weight_kg> <height_cm> <age> <M|F> <activity 1-5>`), and pitfalls give concrete mitigations (add `language=2`, `status=2`, `sleep 2`). This matches anchor 5: fully executable, specific examples covering the common cases.

5 / 5

Workflow Clarity

The exercise lookup is a clear numbered sequence (Step 1 identify → Step 2 reference IDs → Step 3 fetch and present), and a dedicated Verification section provides checkpoints with a sanity range ("TDEE should be 1500-3500"), plus rate-limit handling for batch requests — satisfying the batch-operations validation requirement. It falls short of anchor 5 because there are no error-recovery feedback loops (what to do when a query returns nothing or an API call fails).

4 / 5

Progressive Disclosure

The body points to real, one-level-deep bundle files — `references/FORMULAS.md` ("See references/FORMULAS.md for the science behind each formula") and `scripts/body_calc.py`, both verified to exist — and sections are clearly organized. Minor gaps keep it from anchor 5: the large ID/equipment tables and Quick Reference are bulk reference data inlined in SKILL.md that could live in `references/`, and `scripts/nutrition_search.py` exists in the bundle but is never referenced from SKILL.md, hurting discoverability.

4 / 5

Total

17

/

20

Passed

Description

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

The description is concise and names a clear domain with concrete data sources, but it reads as a capability label rather than a full description: it lacks a 'Use when...' trigger clause and omits many natural trigger keywords (calories, diet, gym, BMI, TDEE). Adding an explicit use-when clause with those terms would raise both completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks about workouts, gym routines, exercises, calories, macros, meal planning, BMI, TDEE, or body fat."

Add natural synonyms users actually say — calories, diet, meal planning, exercise, gym, BMI, TDEE, one-rep max — to broaden trigger coverage.

Convert noun phrases into action verbs ("Plans workouts, calculates macros and body metrics...") to sharpen the statement of capabilities.

DimensionReasoningScore

Specificity

"Workout planning, macros, and body metrics via wger/USDA" names the domain and three capability areas plus the concrete data sources, but uses noun phrases rather than action verbs — matching anchor 3 (names domain and some concrete actions, not comprehensive) and below anchor 4, whose example lists several specific action verbs like 'Extracts... fills... converts'. It exceeds anchor 2 because it names three distinct capability areas and the specific systems used, not merely a generic domain.

3 / 5

Completeness

The 'what' is clearly stated (workout planning, macros, body metrics via wger/USDA) but there is no 'Use when...' clause or equivalent trigger guidance, so per the rubric guideline completeness is capped at 3 — a clear 'what' with 'when' missing or only weakly implied.

3 / 5

Trigger Term Quality

"Workout planning", "macros", and "body metrics" are natural terms users would say, but common synonyms and specific phrases are missing — calories, diet, meal planning, gym, exercise, BMI, TDEE, body fat, 1RM. This fits anchor 3 (some relevant keywords but missing common variations) rather than anchor 4 (good coverage with only a few terms missing), since several high-frequency user phrasings are absent.

3 / 5

Distinctiveness Conflict Risk

The fitness/nutrition niche with named data sources (wger, USDA) is fairly distinct, but a broader health/diet or general nutrition skill could overlap on terms like 'macros' or 'body metrics' — matching anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than anchor 5's clear niche with distinct triggers, since the description lacks the distinctive trigger phrases that would fully separate it.

4 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
NousResearch/hermes-agent
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.