CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

typescript-advanced-types

Comprehensive guidance for mastering TypeScript's advanced type system including generics, conditional types, mapped types, template literal types, and utility types for building robust, type-safe applications.

36

Quality

46%

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-claude/skills/typescript-advanced-types/SKILL.md

The canonical home for this skill is typescript-advanced-types in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

11%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 boilerplate skeleton: a description restated verbatim, a vacuous 'Do not use' section, generic non-actionable Instructions, and all real substance deferred to a playbook file that is missing from the bundle. Nothing in the body is skill-specific, executable, or sequenced.

Suggestions

Replace the generic Instructions ('Apply relevant best practices and validate outcomes') with concrete, skill-specific guidance or worked TypeScript type examples directly in the body.

Ship the referenced `resources/implementation-playbook.md` — it is absent from the bundle, leaving a dangling pointer — or remove the reference until the file exists.

Cut the boilerplate: the intro duplicates the frontmatter description and the 'Do not use this skill when' bullets are tautological, adding no information.

DimensionReasoningScore

Conciseness

Several sections are boilerplate padding: the intro restates the frontmatter description verbatim ("Comprehensive guidance for mastering TypeScript's advanced type system..."), the Instructions are generic template text ("Apply relevant best practices and validate outcomes", "Provide actionable steps and verification"), and the 'Do not use this skill when' bullets are vacuous ("The task is unrelated to typescript advanced types"). This matches anchor 2's 'several unnecessary explanations or padded sections'; it stays above anchor 1 because there is no concept-explanation bloat and the 'Use this skill when' list does carry trigger value.

2 / 5

Actionability

The Instructions are entirely abstract directives — "Clarify goals, constraints, and required inputs", "Apply relevant best practices and validate outcomes" — with no code, commands, or skill-specific steps anywhere in the body, matching anchor 1 ('only describes rather than instructs'). It does not reach anchor 2 because even the single high-level pointer, `resources/implementation-playbook.md`, targets a file that does not exist in the bundle, so there is no usable concrete guidance at all.

1 / 5

Workflow Clarity

No steps or sequence are given anywhere in the body; the Instructions are unordered generic bullets with no checkpoints and no validation, matching anchor 1 ('steps missing or incoherent; no sequence'). Anchor 2 is not met because even a rough, gapped sequence is absent, and the simple-skill exception does not apply since this claims comprehensive multi-topic coverage rather than one unambiguous action.

1 / 5

Progressive Disclosure

The body defers all substance to `resources/implementation-playbook.md` (referenced in both Instructions and Resources), but the bundle contains no `resources/` directory — nor any references/, scripts/, or assets/ — so the single reference is dangling and navigation leads nowhere. Scored against the actual bundle structure, this is minimal effective structure (anchor 2) rather than anchor 3, since the one reference resolves to nothing on disk.

2 / 5

Total

6

/

20

Passed

Description

56%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 clearly scopes a niche domain (TypeScript's advanced type system) and includes strong natural trigger keywords like generics, conditional types, and utility types. However, it states no concrete actions and omits any 'use when' trigger guidance, which caps completeness at 3 and keeps specificity low, with 'Comprehensive guidance for mastering' and 'robust, type-safe applications' reading as fluff.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger situations, e.g., 'Use when writing, debugging, or refactoring TypeScript generics, conditional types, or type-level utilities.'

Replace the vague opener with concrete actions, e.g., 'Design and refactor TypeScript types: conditional types, mapped types, template literal types, and generic constraints.'

Trim over-claims and filler like 'Comprehensive guidance for mastering' and 'robust, type-safe applications', which add no trigger value.

DimensionReasoningScore

Specificity

The description names the domain and subtopics ("TypeScript's advanced type system including generics, conditional types, mapped types, template literal types, and utility types") but contains no concrete actions — the only verbs are the generic "guidance for mastering" and "building robust, type-safe applications" — matching the anchor 'Names the domain but actions are minimal or generic'. It falls below anchor 3 because no concrete action (e.g., 'write conditional types', 'refactor generic components') is stated, and 'Comprehensive guidance for mastering' plus 'robust, type-safe applications' reads as vague fluff.

2 / 5

Completeness

The 'what' is stated and clearly scoped (guidance covering generics through utility types), but the 'when' is entirely absent — there is no "Use when..." clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. It does not drop to 2 because the 'what' is concrete in domain and topic coverage rather than vague.

3 / 5

Trigger Term Quality

Natural phrases users would say are present — "generics", "conditional types", "mapped types", "template literal types", "utility types", "type-safe" — giving good keyword coverage, but common variations like "type inference", "strict typing", "typing", or the ".ts" extension are missing, so it lands on anchor 4 rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The niche focus on "TypeScript's advanced type system" with named subtopics (conditional types, template literal types) is mostly distinct from other skills, with only minor overlap risk against a general TypeScript skill — matching anchor 4. It does not reach anchor 5 because without explicit trigger phrases, generic TypeScript queries could still pull it in alongside a broader TypeScript skill.

4 / 5

Total

13

/

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-claude/skills/typescript-advanced-types/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.