CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

typescript-development

Modern TypeScript conventions for library-agnostic code — strict mode, naming, type annotations, the type system (generics, utility types, conditional and mapped types), discriminated unions, error handling, async patterns, immutability, and project structure. Use when the user asks to "write TypeScript code", "create a TypeScript module", "define TypeScript types", "add type annotations", "use generics", "handle errors in TypeScript", "set up tsconfig" or "organize a TypeScript project", or whenever writing any TypeScript that is not tied to a specific library or framework. Does not cover React or other UI frameworks (react-best-practices, react-feature-sliced-design), CLI packaging and npm publishing (npx-package), plain JavaScript with no types, or service-specific APIs such as DynamoDB (aws-dynamodb-best-practices).

Quality

94%

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.

A strong, highly actionable conventions body with excellent progressive disclosure into a well-organized reference bundle. Its only weaknesses are modest redundancy (the mistakes table and a few explanatory asides) and the absence of a compile-time verification step to close the loop on the strict-mode rules.

Suggestions

Trim the 'Quick Reference: Common Mistakes' table to mistakes not already restated as rules in the preceding sections (e.g., the `any`, bare catch, and ESM-extension rows repeat verbatim guidance above), or fold it into the reference files.

Add a brief verification step — e.g., 'Verify compliance with `tsc --noEmit`' — so the strict-mode and type-annotation rules have an explicit checkpoint.

Cut explanatory asides that restate TypeScript knowledge Claude already has, such as the bundler/tree-shaking rationale under 'Const Objects Over Enums'.

DimensionReasoningScore

Conciseness

Sections are directive with dense tables and short, purposeful code blocks — genuinely efficient overall. However, the "Quick Reference: Common Mistakes" table restates rules already covered in the preceding sections, and asides like the "**Why:** as const is erased... bundler can tree-shake" explanation restate TypeScript knowledge Claude already has. Anchor 4 (minor trimmable instances) fits better than anchor 5 (every token earns its place) and better than anchor 3 (only minor tightening needed, not pervasive).

4 / 5

Actionability

Concrete, executable TypeScript throughout: bad/good code pairs (the `any` vs `unknown` narrowing example), a naming table with real identifiers, real tsconfig/import rules ("import { helper } from \"./utils.js\" // Correct"), and a full discriminated-union pattern. Code is copy-paste ready and covers the common cases, matching anchor 5.

5 / 5

Workflow Clarity

This is a conventions skill, and its per-topic rules are unambiguous (e.g., "Variables — only when the type cannot be inferred", "Always enable `strict: true`"). But there is no verification checkpoint (e.g., running `tsc --noEmit` to confirm compliance), and the simple-skill exception for scoring 5 applies to sub-50-line single-task bodies, which this ~230-line multi-topic body is not. Anchor 4 (clear, minor validation gap) fits better than 3, whose 'sequence present but checkpoints missing' implies vague or implicit steps.

4 / 5

Progressive Disclosure

The body is an overview of core conventions with depth correctly pushed to four real, one-level-deep reference files. "Additional Resources" summarizes what each file owns ("Each topic lives in exactly one file — open the one that owns it"), and in-text pointers are section-specific ("references/patterns.md (Assertion Functions)", "references/project-structure.md (Import Organization)"). All cited paths exist in the bundle. This matches anchor 5: clear overview, well-signaled shallow references, easy navigation.

5 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: it states concrete capabilities, quotes natural trigger phrases, defines both positive and negative scope, and names sibling skills to avoid mis-triggering. Every dimension lands on the top anchor with no padding or over-claims.

DimensionReasoningScore

Specificity

The description enumerates concrete capability areas — "strict mode, naming, type annotations, the type system (generics, utility types, conditional and mapped types), discriminated unions, error handling, async patterns, immutability, and project structure" — comprehensively covering the skill's scope. It fits the anchor-5 example (multiple specific items, comprehensive coverage) rather than anchor 4, which reserves room for coverage gaps that are not present here.

5 / 5

Completeness

It explicitly answers both what (the enumerated convention topics) and when (quoted trigger phrases plus a general condition), matching the anchor-5 pattern of the good example. Anchor 4 would require the 'when' to be less explicit, but the quoted trigger list is maximally concrete.

5 / 5

Trigger Term Quality

It quotes natural user utterances — "write TypeScript code", "create a TypeScript module", "define TypeScript types", "add type annotations", "use generics", "handle errors in TypeScript", "set up tsconfig", "organize a TypeScript project" — plus a broad catch-all ("whenever writing any TypeScript that is not tied to a specific library or framework"). This is comprehensive natural-term coverage with variations, matching anchor 5; anchor 4 would apply only if common phrasings were missing, and none are.

5 / 5

Distinctiveness Conflict Risk

"library-agnostic" plus explicit negative scope naming sibling skills — React/UI frameworks ("react-best-practices, react-feature-sliced-design"), CLI packaging ("npx-package"), plain JavaScript, and service APIs ("aws-dynamodb-best-practices") — carves a clear niche. Minimal conflict risk, matching anchor 5; anchor 4's 'minor overlap risk with closely related skills' is undercut by the explicit exclusion list.

5 / 5

Total

20

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

provectus/awos-recruitment

Path

registry/skills/typescript-development/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.