CtrlK
BlogDocsLog inGet started
Tessl Logo

fp-either-ref

Quick reference for Either type. Use when user needs error handling, validation, or operations that can fail with typed errors.

66

Quality

80%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/fp-either-ref/SKILL.md

The canonical home for this skill is fp-either-ref in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

An efficient, highly actionable quick-reference card with copy-paste TypeScript examples and clean sectioning. Its only limitation is the absence of any progressive-disclosure split or external references, which is acceptable for a reference skill but caps the structure dimension.

DimensionReasoningScore

Conciseness

The body is lean and code-first ("Either = success or failure. Right(value) or Left(error)."), assumes Claude's competence, and every section earns its place with no padding or restating of basics.

5 / 5

Actionability

Provides copy-paste-ready, executable TypeScript covering create/transform/extract plus common patterns (validation chain, JSON parse via tryCatch), spanning the typical cases a user would need.

5 / 5

Workflow Clarity

Content is clearly organized into Create/Transform/Extract/Patterns sections and the chained-validation example sequences steps; as a reference card it has no destructive or batch operation requiring explicit validation checkpoints, so it stays just below 5.

4 / 5

Progressive Disclosure

A single self-contained file with well-signaled section headers and no nested references; slightly above 50 lines and all content inline, so it is well-structured but not the cleanest possible split for a 5.

4 / 5

Total

18

/

20

Passed

Description

70%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 concise, well-targeted description that pairs a clear "what" with an explicit "Use when" trigger clause and natural keywords. It is slightly held back by a terse "what" and limited concrete-action listing.

Suggestions

Expand the "what" clause to name concrete actions the reference supports (e.g., "create, transform, and chain Either values"), which would raise specificity and completeness.

Add natural synonyms a user might say (e.g., "Result type", "success/failure types") to broaden trigger-term coverage.

Consider including the fp-ts library name in the description to sharpen distinctiveness against generic error-handling skills.

DimensionReasoningScore

Specificity

Names the domain ("Either type") and concrete use cases (error handling, validation, operations that can fail with typed errors), but describes the artifact as a "quick reference" rather than listing multiple concrete actions, so coverage is not comprehensive.

3 / 5

Completeness

Has both a clear "what" ("Quick reference for Either type") and an explicit "Use when..." clause with concrete triggers; the "what" is somewhat terse, keeping it just below a 5.

4 / 5

Trigger Term Quality

Includes natural terms users would say ("error handling", "validation") plus the more technical "typed errors"; good keyword coverage though a few natural synonyms are missing.

4 / 5

Distinctiveness Conflict Risk

The Either type and fp-ts error-handling niche is a distinct trigger space with minimal conflict risk, though it could marginally overlap with general error-handling skills.

4 / 5

Total

15

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.