CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

react-sync

Build local React changes in the bundle variants consumed by Next.js, sync them into a local Next.js checkout, and test the resulting integration. Use when working on React changes that need validation in Next.js, or when asked to run buildForNext, pnpm sync-react, or synchronize a React checkout with Next.js.

Quality

85%

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

78%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 tight, well-structured skill body: concrete commands, a correctly externalized build script, and non-obvious environment-specific knowledge (the Corepack PATH workaround) that justifies its space. The main gap is the final verification step, which tells the agent to inspect and run tests without giving a concrete inspection or test command.

Suggestions

Make step 3's checkpoint executable: give one concrete inspection command (e.g. 'git -C <next-repo> status' or a diff of the vendored React directory) and an example focused-test invocation, instead of the abstract 'run the focused test command matching the changed behavior'.

Tighten the Codex PATH explanation to the essential mechanism (Corepack shim must precede the bundled pnpm on PATH for the nested install to resolve correctly); the final sentence largely repeats what the preceding two already established.

Either name the placeholders' typical values once (e.g. '<react-repo> is the react checkout root, <next-repo> this repository root) or define them at the top so the copy-paste commands are closer to fully executable.

DimensionReasoningScore

Conciseness

The body is lean — numbered steps with two short command blocks and no padding of concepts Claude already knows. The seven-line Codex PATH-precedence explanation is environment-specific bug knowledge Claude could not derive, so it earns its tokens, though it could be trimmed slightly ('Invoking only the outer command with corepack pnpm is insufficient...' restates the mechanism). This puts it at efficient-with-minor-trim-potential (4) rather than the flawless 5 anchor.

4 / 5

Actionability

Both core steps give concrete, executable shell commands ('bash <next-repo>/.agents/skills/react-sync/scripts/build-for-next.sh', 'pnpm sync-react --version <react-repo>') including the PATH workaround. It stops short of the 5 anchor because commands use unsubstituted placeholders and step 3 gives only vague direction ('run the focused test command matching the changed behavior') with no example command, leaving minor gaps.

4 / 5

Workflow Clarity

A clear three-step build → sync → inspect/test sequence with a genuine checkpoint: 'Inspect the sync result before testing. Preserve unrelated changes in both checkouts.' This satisfies the validation expectation (so the batch/destructive cap of 3 does not apply), but the checkpoint is not executable — no command or criterion for how to inspect — and there is no error-recovery loop, which keeps it at 4 rather than the 5 anchor.

4 / 5

Progressive Disclosure

The SKILL.md is a ~40-line overview: the full build logic is properly externalized into the real one-level-deep bundle file scripts/build-for-next.sh (verified to exist), referenced by explicit absolute path with a note on what it produces ('build/oss-stable and build/oss-experimental'). Sections ('Build and sync', 'Related Skills') are well organized with no inlined content that belongs in a separate file, matching the 5 anchor for a short, well-structured skill.

5 / 5

Total

17

/

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: it pairs a concrete what (build, sync, test) with an explicit multi-phrase 'Use when' trigger clause naming the exact commands users would mention. The only weak spot is slightly restrained keyword coverage on the natural-language side.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Build local React changes in the bundle variants', 'sync them into a local Next.js checkout', and 'test the resulting integration' — all in third-person imperative voice. It falls short of the 5 anchor because coverage stops at three high-level actions with no further specificity about what syncing or testing entails, and it is above 3 because multiple distinct actions are named rather than 1-2.

4 / 5

Completeness

It explicitly answers both questions: the 'what' is 'Build local React changes... sync them into a local Next.js checkout, and test the resulting integration', and the 'when' is a full 'Use when...' clause with concrete triggers ('working on React changes that need validation in Next.js, or when asked to run buildForNext, pnpm sync-react, or synchronize a React checkout with Next.js'). This matches the score-5 anchor; there is no missing or implicit half.

5 / 5

Trigger Term Quality

Natural user phrasings are present: 'React changes that need validation in Next.js', 'synchronize a React checkout with Next.js', plus the specific command names 'buildForNext' and 'pnpm sync-react'. It sits at 4 rather than 5 because a few natural synonyms and variations (e.g. 'sync React into Next', 'React canary/experimental builds') are missing, but keyword coverage is solid rather than partial.

4 / 5

Distinctiveness Conflict Risk

This occupies a clear niche — building React bundle variants and syncing them into a Next.js checkout — anchored by distinctive named commands ('buildForNext', 'pnpm sync-react') that no generic build or test skill would claim. Conflict risk with other skills is minimal, matching the score-5 anchor rather than the 4 anchor's 'minor overlap risk with closely related skills'.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

vercel/next.js

Path

.agents/skills/react-sync/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.