CtrlK
BlogDocsLog inGet started
Tessl Logo

react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. Use when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements. Do NOT use for component API architecture or composition patterns (use react-composition-patterns instead).

64

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

50%

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 clean, prioritized rule catalog that assumes Claude's competence, but it offers no inline executable examples and advertises reference files (rules/*.md, AGENTS.md) that are absent from the bundle. Scoring 2 across the board reflects solid structure without the executable depth or backed references needed for a 3.

Suggestions

Bundle the referenced per-rule files (rules/*.md) and AGENTS.md, or remove the references — advertising files that are not present undermines the skill's progressive disclosure.

Add at least one short inline executable code example for the CRITICAL categories (e.g. a Promise.all before/after for async-parallel) so the skill is actionable without opening every rule file.

Add a brief verification step in 'How to Use' (e.g. how to confirm a refactor preserved behavior) so the workflow has an explicit checkpoint for batch refactoring operations.

DimensionReasoningScore

Conciseness

Lean and table-driven with no padding about what React/Next.js is, but the full enumeration of all 57 rule names is somewhat redundant token-wise given the detail lives in per-rule files; the listing could be tightened.

2 / 3

Actionability

Provides one-line guidance per rule (e.g. 'async-parallel - Use Promise.all() for independent operations') but no inline executable code examples; it deliberately directs the reader to rule files for code, leaving inline guidance incomplete.

2 / 3

Workflow Clarity

The prioritized category table and 'How to Use' section give a readable structure, but the workflow is essentially 'read the rule files' with no validation or verification checkpoints; for this reference skill the sequence is present but implicit.

2 / 3

Progressive Disclosure

The overview is well-structured and signals one-level-deep references ('rules/async-parallel.md', 'AGENTS.md'), but those referenced paths do not exist in the bundle, so the navigation it advertises is not actually backed by files.

2 / 3

Total

8

/

12

Passed

Description

100%

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 is excellent: concise, third-person, with explicit what/when triggers, natural keywords, and strong disambiguation against a sibling skill. It hits the top anchor on every dimension.

DimensionReasoningScore

Specificity

Lists multiple concrete concerns — 'writing, reviewing, or refactoring React/Next.js code', 'data fetching, bundle optimization, or performance improvements' — naming both the domain and specific actions rather than vague language.

3 / 3

Completeness

Explicitly answers both 'what' ('React and Next.js performance optimization guidelines from Vercel Engineering') and 'when' with a clear 'Use when...' and 'Triggers on...' clause.

3 / 3

Trigger Term Quality

Natural user-facing terms are covered well: 'React components', 'Next.js pages', 'data fetching', 'bundle optimization', and 'performance improvements' are exactly the phrasings a user would invoke.

3 / 3

Distinctiveness Conflict Risk

Clear niche with an explicit negative trigger — 'Do NOT use for component API architecture or composition patterns (use react-composition-patterns instead)' — disambiguating a named sibling skill.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
tech-leads-club/agent-skills
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.