CtrlK
BlogDocsLog inGet started
Tessl Logo

typescript-expert

TypeScript expert for type system, generics, utility types, and strict mode patterns

67

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 ./crates/openfang-skills/bundled/typescript-expert/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is lean, concrete, and well-organized, delivering executable patterns without padding and clear sectioning appropriate for a short reference skill with no external bundle.

DimensionReasoningScore

Conciseness

The body is dense and high-signal — e.g., 'Treat `any` as a code smell; use `unknown` for truly unknown values' and 'Do not use `enum` for string constants' — with no padding explaining what TypeScript is or how basic concepts work. Every token earns its place, matching the lean/efficient anchor and not the 'mostly efficient but could be tightened' level.

3 / 3

Actionability

Provides concrete, executable snippets — 'function merge<T extends object, U extends object>(a: T, b: U): T & U', mapped/conditional types, type guards, branded types, and 'assertNever' — that are copy-paste ready. It is not level 2 because the code is real and complete rather than pseudocode or missing key details.

3 / 3

Workflow Clarity

This is a single-purpose reference skill with no multi-step or destructive workflow, and the material is clearly organized into Key Principles, Techniques, Common Patterns, and Pitfalls. Per the simple-skills note, workflow clarity can score 3 when the content is clear and well-organized.

3 / 3

Progressive Disclosure

The skill is under 50 lines with no external references and no bundle files, and content is organized into clear, well-signaled sections. Per the guideline, progressive disclosure can score 3 for short skills needing no external references when sections are well-organized.

3 / 3

Total

12

/

12

Passed

Description

60%

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 specific about capability areas but lacks any 'Use when...' trigger guidance, capping its completeness. Trigger terms are relevant but skew technical and miss natural user phrasing.

Suggestions

Add an explicit 'Use when...' clause naming natural trigger scenarios (e.g., 'Use when fixing type errors, designing generic APIs, configuring strict tsconfig, or debugging type narrowing').

Include common user-facing terms alongside the technical ones, such as 'type safety', 'type errors', and 'tsconfig'.

Narrow 'TypeScript expert' toward the type-system niche to reduce overlap with general TypeScript/coding skills.

DimensionReasoningScore

Specificity

Names the domain (TypeScript) and lists multiple concrete capability areas — 'type system, generics, utility types, and strict mode patterns' — rather than vague abstractions. It is above level 2 because the coverage spans four distinct, specific topics rather than just naming the domain.

3 / 3

Completeness

It answers 'what does this do' (expert for type system, generics, utility types, strict mode) but has no 'Use when...' clause or equivalent explicit trigger guidance, which per the guidelines caps completeness at 2. It is not level 3 because the 'when' is entirely missing.

2 / 3

Trigger Term Quality

Relevant keywords like 'TypeScript', 'generics', and 'strict mode' appear, but the phrasing leans technical and misses common natural variations a user might say ('type errors', 'type safety', 'fixing types', 'tsconfig'). It is not level 3 because keyword coverage is not broad enough for natural user phrasing, and not level 1 because clearly relevant terms are present.

2 / 3

Distinctiveness Conflict Risk

The focus on type-system specifics (generics, utility types, strict mode) carves a niche, but the generic 'TypeScript expert' framing with no narrowing trigger could still overlap with general TS or coding skills. It is not level 3 because the broad 'expert' framing lacks distinct triggers, and not level 1 because it is clearly domain-specific rather than generic.

2 / 3

Total

9

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
RightNow-AI/openfang
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.