CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

typescript-language

Apply modern TypeScript standards for type safety and maintainability. Use when working with types, interfaces, generics, enums, unions, or tsconfig settings.

64

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, highly actionable rulebook with an explicit verification checkpoint and a clean two-file reference structure. Its only weakness is a few spots where guidance names a rule without a matching example (tsconfig strict settings, narrowing patterns).

DimensionReasoningScore

Conciseness

Telegraphic bullets ("Enums: Literal unions or `as const`. **No runtime `enum`**.") state project standards without re-explaining TypeScript concepts Claude already knows. Every token carries a rule or an example; only the "Priority: P0 (CRITICAL)" heading is arguably filler, which does not drop it below anchor 5.

5 / 5

Actionability

Concrete, executable guidance throughout: specific syntax (`?.`, `??`, `satisfies`, `string & { __brand: 'Id' }`), a runnable code block, and a named verification tool (`getDiagnostics` via typescript-lsp MCP). Minor gaps — e.g. no tsconfig example for "strict: true" and no narrowing example to complement the "no `!`" rule — keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

As a single-purpose standards skill, the action is unambiguous (apply the listed rules), and the Verification section provides an explicit checkpoint: "call `getDiagnostics` ... to confirm no type errors before finalizing", with clear scoping of when it applies. It is a rule reference rather than a sequenced multi-step workflow with recovery steps, so it fits anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The ~60-line body stays an overview: testing gotchas are pushed to references/TESTING.md and advanced/utility patterns to references/REFERENCE.md, both verified to exist, clearly signaled with markdown links, and only one level deep. This matches the anchor-5 pattern of a clear overview with well-signaled references.

5 / 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.

The description clearly answers both what the skill does and when to use it, with a strong explicit trigger clause. Its main weakness is an abstract "what" — it applies standards rather than naming concrete capabilities.

Suggestions

Replace the abstract action with 2-3 concrete capabilities, e.g. "Define type-safe interfaces, generics, discriminated unions, and tsconfig strict settings".

Add commonly-said trigger terms and file extensions, e.g. ".ts/.tsx files, strict mode, type guards".

DimensionReasoningScore

Specificity

"Apply modern TypeScript standards for type safety and maintainability" names the domain but the action itself is abstract — no concrete operations like "define discriminated unions" or "configure strict mode" are listed. It sits above anchor 2 (more focused than "Processes PDF files") but lacks the list of specific actions needed for anchor 4.

3 / 5

Completeness

Both parts are present: the what ("Apply modern TypeScript standards for type safety and maintainability") and an explicit when ("Use when working with types, interfaces, generics, enums, unions, or tsconfig settings"). The when clause is strong with concrete triggers, but the what is abstract, so it does not clearly match anchor 5's fully concrete example.

4 / 5

Trigger Term Quality

"types, interfaces, generics, enums, unions, or tsconfig settings" are natural terms users would say when needing this skill, and "tsconfig" is distinctive. It falls short of anchor 5 because file extensions (.ts/.tsx) and common variations like "strict mode" or "type guards" are missing.

4 / 5

Distinctiveness Conflict Risk

"tsconfig", "generics", and "enums" clearly signal the TypeScript niche, keeping conflict risk low. There is minor overlap risk with closely related skills (general JavaScript style or linting skills), which fits anchor 4 rather than the clean niche of anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

.github/skills/typescript/typescript-language/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.