CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

typescript

Use this guide when working on TypeScript changes in the FAST monorepo — authoring Web Components, writing templates and styles, working with the observable/reactive system, and testing.

Quality

83%

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

71%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 well-organized, code-first patterns reference with concrete, near-executable guidance throughout and minimal padding. Its main structural weakness is the absence of any progressive disclosure: all detail lives inline in a single long file, and one test snippet has unresolved imports.

Suggestions

Split secondary reference material (binding syntax table, testing harness details, TypeScript idioms) into one-level-deep files under references/ and link them from short overview sections.

Tighten the Browser APIs section by dropping the framework-stance rationale and keeping only the two lists of APIs.

Fix the direct-import test example to import or define `Model` and `PropertyChangeNotifier` so it is copy-paste runnable.

DimensionReasoningScore

Conciseness

The body is largely lean and code-first ('Elements extend `FASTElement`. Do **not** use the `@customElement` decorator.'), assuming Claude's competence. Minor over-explanation remains, e.g., 'Our stance as a framework library is that certain browser APIs are best avoided...' and the rationale sentence under 'Avoid', which fits anchor 4 rather than 5.

4 / 5

Actionability

Nearly all guidance is executable: concrete import paths, `define()` registration, `html`/`css` tagged templates, a binding-syntax table, and full test patterns. Small gaps keep it at anchor 4: the direct-import test snippet references `Model` and `PropertyChangeNotifier` without importing them, and `await MyElement.define(...)` appears without a wrapping context.

4 / 5

Workflow Clarity

This is a topic-organized pattern reference rather than a multi-step workflow, and its sections are unambiguous, with the testing section clearly sequencing direct-import vs browser-evaluated approaches and stating the `page.evaluate` serializability constraint. It does not reach anchor 5 because no explicit verification guidance exists for applying the patterns.

4 / 5

Progressive Disclosure

There are no bundle files at all, so everything — including secondary reference material like the full binding syntax table, test harness details, and TypeScript idiom deep-dives — is inlined in a ~286-line SKILL.md. Section headers give reasonable structure, matching anchor 3 ('some structure... content that should be separate is inline'), but one-level-deep references would materially reduce the always-loaded footprint.

3 / 5

Total

15

/

20

Passed

Description

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

A strong description: concrete, lean, and explicitly scoped with both a clear 'what' and a natural 'when' clause tied to the FAST monorepo. The only weakness is modest keyword breadth — a few natural synonyms and file-extension triggers are absent.

Suggestions

Add one or two natural synonyms such as 'custom elements' or '.ts files' to broaden trigger coverage.

Consider naming the module/import-convention guidance that forms a significant part of the body's content.

DimensionReasoningScore

Specificity

The description lists four concrete capability areas — 'authoring Web Components, writing templates and styles, working with the observable/reactive system, and testing' — with no vague filler. It stops short of anchor 5 because coverage has minor gaps (e.g., module conventions and TypeScript idioms covered in the body are not named).

4 / 5

Completeness

It explicitly answers both questions: 'Use this guide when working on TypeScript changes in the FAST monorepo' (when) followed by a concrete capability list (what). This matches anchor 5; it is not 4 because the trigger clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

It includes natural terms a FAST contributor would actually say — 'TypeScript changes', 'FAST monorepo', 'Web Components', 'templates and styles', 'testing'. A few natural terms are missing (e.g., 'custom elements', 'decorators', '.ts'), so it fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Scoping to 'the FAST monorepo' with FAST-specific capabilities (observable/reactive system, Web Components) creates a clear niche with minimal risk of firing for unrelated TypeScript skills. This matches anchor 5.

5 / 5

Total

18

/

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

microsoft/fast

Path

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