CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

js-ts-authoring

Write or revise JavaScript and TypeScript source, including scripts, tests, and Svelte modules. Apply its documentation and Prettier practices.

Quality

79%

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 ./.agents/skills/js-ts-authoring/SKILL.md
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 an exemplary lean, directive skill: two well-scoped sections, executable formatting commands, package-specific conventions, and explicit validation and reporting requirements. Its only gaps are that the type/lint/test check commands are left generic relative to the fully specified Prettier commands, and there is no guidance on recovering from a failed check.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — it explains no concepts Claude already knows and every bullet adds package-specific guidance (AGENTS.md conventions, protobuf regeneration, mise/pnpm commands), fitting 'every token earns its place' rather than the anchor 4 case of trimmable over-explanation.

5 / 5

Actionability

The formatting section gives fully executable, copy-paste commands ("mise x -- pnpm format -- path/to/file.ts path/to/other-file.mjs" plus the :check variant) and the coding rules are specific ("Narrow unknown before use", "Avoid any"), but "Run the relevant type, lint, and test checks" stops short of naming the commands the way the format section does — minor gaps matching anchor 4.

4 / 5

Workflow Clarity

A clear sequence is present (read AGENTS.md conventions → write code to the stated practices → run Prettier with explicit format and format:check commands → run type/lint/test checks → report what ran), with most checkpoints present; it stays at anchor 4 rather than 5 because there is no error-recovery loop if format:check or the type/lint/test checks fail, and those check commands are unspecified. The cap at 3 does not apply since this is authoring, not a destructive or batch operation.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (no bundle files exist), and is organized into two clearly headed sections ("Write code that explains its behavior", "Format every source edit") with pointers to repo-local sources (AGENTS.md, the repository's Svelte skills) rather than inlined bulk content — per the rubric's simple-skill guideline this qualifies for 5.

5 / 5

Total

18

/

20

Passed

Description

61%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 states what the skill does and uses natural, recognizable terms (JavaScript, TypeScript, Svelte, Prettier), but it entirely lacks a 'when to use' trigger clause and its second sentence gestures vaguely at "its documentation and Prettier practices" without specifics. It is serviceable but below the standard of the good examples, which pair concrete actions with explicit trigger conditions.

Suggestions

Add an explicit trigger clause, e.g. "Use when writing, editing, or refactoring JavaScript or TypeScript files (.js, .ts, .tsx, .svelte), including tests and scripts."

Make the second sentence concrete instead of "Apply its documentation and Prettier practices" — e.g. "document public functions with JSDoc and format changed files with Prettier."

Include file extensions or common synonyms (.ts, .tsx, .js, .mjs, "format") so the description matches how users actually phrase requests.

DimensionReasoningScore

Specificity

The description names the domain ("JavaScript and TypeScript source, including scripts, tests, and Svelte modules") with two concrete actions ("Write or revise" and "Apply its documentation and Prettier practices"), but the practices half is underspecified and coverage is not comprehensive, matching the 'domain plus 1-2 concrete actions' anchor rather than 'several specific actions'.

3 / 5

Completeness

The 'what' is clear ("Write or revise JavaScript and TypeScript source... Apply its documentation and Prettier practices") but there is no 'Use when...' clause or equivalent explicit trigger guidance, which the guidelines say caps completeness at 3; the 'when' is not even weakly implied, so it cannot reach anchor 4.

3 / 5

Trigger Term Quality

Good natural keyword coverage — "JavaScript", "TypeScript", "scripts", "tests", "Svelte", "Prettier" are terms users would actually say — but common variations like file extensions (.ts, .tsx, .js) and terms like "format" or "frontend" are missing, matching 'good keyword coverage; a few natural terms missing' rather than the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

The JS/TS authoring niche with Prettier and Svelte specifics is mostly distinct with only minor overlap risk against generic coding or Svelte-focused skills, but "Write or revise JavaScript and TypeScript source" is broad enough to fire on nearly any JS task, keeping it below the 'clear niche with minimal conflict risk' anchor.

4 / 5

Total

14

/

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

chattocorp/chatto

Path

.agents/skills/js-ts-authoring/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.