CtrlK
BlogDocsLog inGet started
Tessl Logo

vercel-react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used 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.

78

1.02x
Quality

68%

Does it follow best practices?

Impact

98%

1.02x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/vercel-react-best-practices/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 a well-organized, token-efficient index of 69 rules with clear priority ordering, but it functions as a pointer document whose targets are missing: no rules/ files and no AGENTS.md exist in the bundle, and the body itself contains no executable guidance. The intended progressive-disclosure structure is right in form but broken in fact.

Suggestions

Ship the referenced files: create the rules/ directory with the individual rule markdown files and AGENTS.md referenced in 'How to Use' and 'Full Compiled Document', so the one-level-deep navigation actually resolves.

Add a small amount of inline executable guidance for the highest-priority rules (e.g., a before/after code snippet for async-parallel and bundle-barrel-imports) so the skill is actionable even before reading rule files.

Make the application workflow explicit: a short sequenced procedure (identify applicable category by impact, read the matching rule files, apply, then verify the change) with a verification checkpoint for refactors.

DimensionReasoningScore

Conciseness

The body is a lean one-line-per-rule index with no explanations of concepts Claude already knows, matching the 'efficient; minor instances that could be trimmed' anchor. It falls below anchor 5 because the full 69-entry catalog partially duplicates content that the referenced rules/ files and AGENTS.md are supposed to carry, and above anchor 3 because there is no padded or unnecessary explanatory prose.

4 / 5

Actionability

Rule entries give directional one-line hints ('Use Promise.all() for independent operations', 'Import directly, avoid barrel files') but no executable code or commands, and the detailed guidance is deferred to files that are not present in the bundle, matching the 'some concrete guidance but incomplete, missing key details' anchor. It is above anchor 2 because rule names and one-liners do point to specific techniques, but below anchor 4 which requires concrete code or commands.

3 / 5

Workflow Clarity

'When to Apply' plus the priority table imply a procedure (pick category by impact, read the rule file, apply), but no explicit step sequence or checkpoints exist for carrying out a review or refactor, matching anchor 3's 'sequence present but checkpoints missing or implicit'. It is not anchor 2 because the priority ordering and when-to-apply conditions do define a rough decision flow; not anchor 4 because no validation of applied changes is mentioned.

3 / 5

Progressive Disclosure

Although references are clearly signaled in text ('rules/async-parallel.md', 'For the complete guide with all rules expanded: AGENTS.md'), none of the referenced files exist in the bundle, so the one-level-deep navigation fails at the first hop. This sits below anchor 3, where references at least resolve; it is not anchor 1 because the body itself is well sectioned and the intended structure is shallow rather than deeply nested.

2 / 5

Total

12

/

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 clearly states what the skill provides and gives explicit, multi-signal trigger guidance in third person. Main weaknesses are a slightly abstract 'what' (guidelines rather than concrete capabilities) and a few missing natural trigger synonyms.

DimensionReasoningScore

Specificity

The description names the domain ('React and Next.js performance optimization guidelines from Vercel Engineering') and several concrete usage actions ('writing, reviewing, or refactoring React/Next.js code'), matching the 'several specific actions with minor gaps' anchor. It falls short of anchor 5 because the deliverable itself is described only as 'guidelines' rather than concrete capabilities, and above anchor 3 because it lists multiple actions rather than 1-2.

4 / 5

Completeness

It explicitly answers what ('React and Next.js performance optimization guidelines from Vercel Engineering') and when ('This skill should be used when writing, reviewing, or refactoring... Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements') with concrete trigger phrases, matching anchor 5 exactly. Anchor 4 is ruled out because the 'when' clause is explicit, specific, and doubled with a trigger list.

5 / 5

Trigger Term Quality

'React components, Next.js pages, data fetching, bundle optimization, or performance improvements' provides good natural keyword coverage matching the 'good coverage, a few natural terms missing' anchor. It is not anchor 5 because common user phrasings such as 'slow rendering', 'speed up my app', or 'bundle size' are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (Vercel-maintained React/Next.js performance), matching the 'mostly distinct, minor overlap risk' anchor; overlap remains with generic React lint or performance skills. It is below anchor 5 because 'performance improvements' and 'writing React components' are broad enough to compete with general React style skills.

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
udecode/plate
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.