CtrlK
BlogDocsLog inGet started
Tessl Logo

runtime-validation

Use when reviewing code that calls fetch(), reads from localStorage, accesses process.env, or processes form submissions without explicitly validating the incoming data shape.

57

Quality

66%

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/runtime-validation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, appropriately split skill: the body carries a clear Check/Fix/Explain/Review workflow with concrete Zod-specific directives, and all implementation detail lives one level deep in a verified, self-contained reference file. The main cost is a concept-explaining intro paragraph and a duplicative Quick Reference bullet that assume Claude doesn't already know TypeScript's compile-time/runtime erasure.

Suggestions

Cut or compress the intro paragraph — Claude already knows TypeScript types are erased at runtime; the Quick Reference already states it in one line.

Trim the redundant Quick Reference bullets that restate the intro, keeping only the non-obvious guidance (e.g., 'validate at trust boundaries only').

Mention the Verification section of references/rule.md in the workflow (e.g., in the Code Review section) so the validation checkpoints are surfaced from the body.

DimensionReasoningScore

Conciseness

The opening paragraph ('TypeScript gives you confidence at compile time, but data from the network... arrives at runtime as raw, untyped values') explains a concept Claude already knows, and the Quick Reference bullet 'TypeScript types are compile-time only — they are completely erased at runtime' restates it. The rest is lean directive prose, so this is more than a minor trim (below anchor 4) but not pervasive padding (above anchor 2).

3 / 5

Actionability

The Fix section gives concrete, named guidance — 'Add Zod schemas', 'Show the schema definition, the validated type inference, and where to call .parse() or .safeParse()' — and the Check section specifies exactly what to report. As an instruction-only skill this is actionable without inline code, but no executable example appears in the body itself (all code lives in references/rule.md), keeping it below anchor 5's copy-paste-ready bar.

4 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections form a clear sequence with explicit deliverables (report, schema + inference + parse placement, explanation, flagged casts). Minor gap: the body never surfaces a verification step, even though references/rule.md contains a Verification section the workflow could point to — anchor 5 requires explicit validation checkpoints within the content.

4 / 5

Progressive Disclosure

The ~30-line body keeps overview and directives inline, and delegates all implementation detail via one clearly signaled, one-level-deep pointer: 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — a real file that is self-contained with no nested references. This matches the anchor's clear-overview/well-signaled-reference structure exactly.

5 / 5

Total

16

/

20

Passed

Description

61%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 strong, specific trigger clause with excellent natural technical terms, but it is a 'when'-only description: the skill's actual capability (runtime schema validation with a library like Zod) is never stated. Adding a leading 'what' clause would make it fully self-describing.

Suggestions

Add a leading capability clause before the trigger, e.g. 'Validates external data at trust boundaries using Zod schemas and type inference. Use when reviewing code that calls fetch()...' so both 'what' and 'when' are explicit.

Include capability keywords users search for — 'runtime validation', 'schema validation', 'Zod' — which are currently absent from the trigger terms.

Add common trigger synonyms such as 'API responses' and 'user input' alongside the existing fetch()/localStorage/process.env/form enumeration.

DimensionReasoningScore

Specificity

The description names the domain ("validating the incoming data shape") and enumerates four concrete code patterns ("calls fetch(), reads from localStorage, accesses process.env, or processes form submissions"), but it lists no capability actions — it never states what the skill actually does. It is more specific than anchor 2's bare domain-name ('Processes PDF files'), but anchor 4 requires several specific actions the skill performs, which are absent.

3 / 5

Completeness

The 'when' is explicit and highly specific ("Use when reviewing code that calls fetch()..."), but the 'what' is entirely missing — the description never states the skill's capability (e.g., adding Zod/runtime schema validation). This mirrors anchor 3's inverse case (clear what, weak when): a clear when with only a weakly implied what via the phrase 'validating the incoming data shape'.

3 / 5

Trigger Term Quality

Natural developer terms are well covered: "fetch()", "localStorage", "process.env", "form submissions", "validating the incoming data shape" — phrases a user would plausibly say. Not 5 because common synonyms and search terms like "API responses", "runtime validation", "schema validation", or "Zod" are missing; not 3 because coverage clearly exceeds 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The trigger carves a clear niche — external data entry points lacking shape validation — with concrete API-level triggers that are distinguishable from generic review skills. Minor overlap risk remains: the condition technically matches any code review of code containing a fetch() call, so it could fire when a general review was intended.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.