CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fp-taskeither-ref

Quick reference for TaskEither. Use when user needs async error handling, API calls, or Promise-based operations that can fail.

Quality

77%

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-taskeither-ref/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 tight, code-first quick reference that demonstrates the core TaskEither operations with realistic patterns and flags the lazy-execution gotcha. The main gaps are minor: undefined helper functions in the pattern examples and a somewhat redundant async/await comparison section.

DimensionReasoningScore

Conciseness

The body is lean and code-dominant with almost no concept re-teaching, but the ~20-line "vs async/await" section is comparative/pitch material that largely duplicates the closing line "Use TaskEither when you need typed errors". This matches anchor 4 (efficient, minor instances that could be trimmed) rather than anchor 5.

4 / 5

Actionability

Concrete, mostly-executable TypeScript throughout (TE.tryCatch wrapping fetch, pipe/flatMap chains, sequenceT parallelism), but Common Patterns references undefined helpers (fetchPosts, fetchComments, defaultUser, toNetworkError, toParseError). That places it at anchor 4 (concrete code with minor gaps) rather than 5 (copy-paste ready covering common cases).

4 / 5

Workflow Clarity

This is a simple, single-purpose reference skill whose sections follow an unambiguous Create → Transform → Execute progression, and the key execution gotcha ("TaskEither is lazy - must call () to run") is explicitly flagged. Per the simple-skill guideline, the single action is unambiguous, warranting 5; there are no risky operations that would demand validation checkpoints.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~95-line body is well-sectioned and self-contained. It scores 4 rather than 5 because it exceeds the under-50-lines guideline for a self-contained skill — the detailed Common Patterns section is borderline content that could be split into a reference file.

4 / 5

Total

17

/

20

Passed

Description

65%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 has an explicit and well-phrased "Use when..." trigger clause covering realistic scenarios, but the "what" half is underdeveloped — it names the artifact (a quick reference for TaskEither) without stating any concrete capabilities. Adding action verbs and the fp-ts library name would lift both specificity and trigger coverage.

Suggestions

Replace "Quick reference for TaskEither" with concrete actions, e.g. "Wrap async/API calls in TaskEither, chain and transform them, and recover from typed errors with fp-ts."

Add "fp-ts" and "functional programming" to the trigger clause so the skill fires when users name the library rather than the type.

Include synonyms like "Task", "Either", or "monadic error handling" in the description to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

"Quick reference for TaskEither" names the domain but offers no concrete actions — "quick reference" is a document type, not a capability verb (no "wrap async calls", "chain operations", "recover from failures"). It matches anchor 2 (names domain, minimal/generic actions) rather than anchor 3, which requires 1-2 concrete actions to be listed.

2 / 5

Completeness

It has both an explicit "Use when..." trigger clause and a "what" ("Quick reference for TaskEither"), so anchor 4 fits. It is not anchor 5 because the "what" is weak — it identifies the artifact type but not what the skill concretely does.

4 / 5

Trigger Term Quality

Natural phrases like "async error handling", "API calls", and "Promise-based operations that can fail" are present and phrased the way users would say them. It falls short of anchor 5 because it omits key synonyms such as "fp-ts", "functional programming", "Task", or "Either".

4 / 5

Distinctiveness Conflict Risk

"TaskEither" carves out a clear niche, but the trigger terms "API calls" and "Promise-based operations" are broad and overlap with generic async/API skills. Anchor 4 (mostly distinct, minor overlap risk) is the best fit; not 5 because those broad triggers could pull in wrong skills.

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

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

Path

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