CtrlK
BlogDocsLog inGet started
Tessl Logo

typescript-rules

React/TypeScript frontend development rules including type safety, component design, state management, and error handling. Use when implementing React components, TypeScript code, or frontend features.

66

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

75%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, opinionated ruleset that assumes competence and stays free of tutorial padding and time-sensitive drift. The main cost is lawyerly over-qualification in a few rules and heavy reliance on 'the repository's established pattern' as the answer, which weakens actionability and leaves validation checkpoints implicit.

Suggestions

Split the compound `any`-retention rule into a short decision list (e.g. 'Retain `any` only if: generated code, legacy public signature, or a generic-relationship constraint — record the proof in a comment'), trimming the 60-word sentences in the Type Safety section.

Add a one-line default for each 'follow the repository's convention' deferral (e.g. 'if no convention exists, prefer X') so the rules remain actionable in greenfield or unconventional repos.

Add a brief validation checkpoint to the error-handling or type-safety flow (e.g. 'run the project type-check before finishing when `any` was introduced or a boundary type changed') to give the rule set an explicit verify step.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive, assumes Claude's competence (never explains what React or TypeScript is), and adds genuinely opinionated rules like "review ownership or splitting above 10" and "handle `string | null`". It is not a 5 because several lawyerly sentences could be tightened, e.g. "Retain `any` only when an existing external, generated, or legacy public signature requires it, or when replacing it prevents the project type check from expressing a safe generic relationship" packs three conditions into one breathless sentence.

4 / 5

Actionability

For an instruction-only skill the guidance is mostly actionable, with concrete numeric thresholds and type shapes: "Prefer 0-2 parameters", "review the boundary when 3+ assertions are required", "treat parsed data as `unknown` until validated". It falls short of 5 because many rules defer to "the repository's established pattern/boundary" without a default when no convention exists, leaving a gap between instruction and execution.

4 / 5

Workflow Clarity

This is a rules reference, not a multi-step workflow, so there is no sequence to validate; organization is by clear topical sections and per-topic guidance is unambiguous, with a few embedded checkpoints ("verify the same signal after the change", "surface any new browser-dependent API as an unresolved compatibility decision"). It does not reach 5 because no explicit validate-and-recover loop exists anywhere, and the pervasive 'follow the repository's convention' deferral leaves checkpoints implicit when conventions are absent.

4 / 5

Progressive Disclosure

No bundle files exist and the body references none, so there are no dangling or nested references; the ~96-line single file is organized under clear section headers (Comment Writing Rules, Type Safety, Coding Conventions, Error Handling, Performance, Non-functional Requirements) making navigation easy. The rubric's 5-exception for under-50-line self-contained skills does not strictly apply here, and some sections (e.g. the multi-paragraph `any` policy) could plausibly live in a reference file, so 4 is the best fit.

4 / 5

Total

16

/

20

Passed

Description

83%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 that states the domain, enumerates the skill's scope, and includes an explicit 'Use when...' trigger clause with natural terms. Main weaknesses are minor: missing synonyms/extensions (.tsx, hooks, JSX) in the triggers and slight overlap risk from the broad 'TypeScript code' trigger.

DimensionReasoningScore

Specificity

The description names the domain ("React/TypeScript frontend development rules") and enumerates four specific areas ("type safety, component design, state management, and error handling"), which lists several specific facets with only minor gaps (performance and coding conventions are covered in the body but not mentioned). It falls below the 5 anchor because these are topic nouns rather than concrete actions like 'extract text' or 'fill forms', and above 3 because coverage of the skill's scope is broad and specific.

4 / 5

Completeness

It clearly answers both questions: the 'what' is explicit ("React/TypeScript frontend development rules including type safety, component design, state management, and error handling") and the 'when' is an explicit 'Use when...' clause with concrete trigger phrases. This matches the 5 anchor's pattern; 'frontend features' is slightly generic but the other two triggers are concrete, keeping it above the 4 anchor where 'when' could be more specific.

5 / 5

Trigger Term Quality

The 'when' clause supplies natural phrases users would actually say: "implementing React components, TypeScript code, or frontend features". It misses common synonyms and file extensions a user might mention (.tsx, .jsx, hooks, JSX), which keeps it below the 5 anchor's 'comprehensive coverage of natural terms including synonyms and file extensions'.

4 / 5

Distinctiveness Conflict Risk

The React/TypeScript frontend niche is mostly distinct with clear triggers, matching the 4 anchor ('mostly distinct; minor overlap risk with closely related skills'). It is not a 5 because "TypeScript code" and "frontend features" could also fire for general TypeScript work or non-React frontend tasks that closely related skills might cover.

4 / 5

Total

17

/

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
shinpr/claude-code-workflows
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.