CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migrate-v8-to-v9

Migrate preact Table v8 to v9. Audit framework construction, rendering, state, and app hooks, with shared API changes in the core migration skill.

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 ./packages/preact-table/skills/migrate-v8-to-v9/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 tightly written, well-sequenced migration checklist that defers detail to a real, load-bearing reference file and closes with concrete verification steps. The main weaknesses are minor: no code in the body itself, no explicit re-validation loop after failures, and cross-skill links that cannot be verified within the bundle.

Suggestions

Make the cross-skill links resilient (e.g. mention they require the sibling getting-started/table-state skills to be present, or move that navigation into the reference file) so the body's links all resolve.

Add one explicit feedback-loop step in 'Verify the migration', e.g. 'If type-check or a feature flow fails, fix the flagged code and re-run before considering the migration complete.'

DimensionReasoningScore

Conciseness

A ~30-line checklist where every line is a directive or a non-obvious, load-bearing fact ('snapshots alone do not rerender consumers', 'Renaming `useReactTable` alone does not complete the migration') with zero padding and no explanation of concepts Claude already knows. This matches anchor 5 exactly: lean, efficient, every token earns its place.

5 / 5

Actionability

Concrete commands ('intent load @tanstack/table-core#migrate-v8-to-v9', inspect 'node_modules/@tanstack/preact-table/dist/index.d.ts') and specific API names throughout, but the body itself carries no code — the executable examples live one level deep in references/adapter-migration.md — and a few items like 'Keep model inputs stable' remain high-level hints. Mostly executable guidance with minor gaps, i.e. anchor 4.

4 / 5

Workflow Clarity

The sequence is clear and ordered: load the core skill, audit, read the detail reference 'before editing' the affected code, then verify via type-checking and exercising every enabled feature flow. Validation checkpoints are present, but there is no explicit fix-and-re-validate feedback loop after type-check or runtime failures, so it stops short of anchor 5.

4 / 5

Progressive Disclosure

The single in-bundle reference (references/adapter-migration.md) exists, is clearly signaled with when to read it, and appropriately holds the detailed mappings and code. However, two of the three body links point outside the bundle to sibling skills (../getting-started/SKILL.md, ../table-state/SKILL.md) that are not resolvable in this environment, and the reference file itself adds a further hop to those same targets — minor organization gaps that keep it at anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

70%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 distinct, concrete description that names the exact migration and the areas it audits, but it omits any 'Use when...' trigger guidance, capping completeness at 3. Adding an explicit trigger clause with terms like 'TanStack' and 'upgrade' would lift both completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. 'Use when migrating or upgrading a TanStack preact-table app from v8 to v9, or when preact table code uses useReactTable or preact/compat aliases.'

Include the natural terms users actually say — 'TanStack Table', 'upgrade', and the package name '@tanstack/preact-table' — to improve trigger-term coverage.

Optionally name one or two more capabilities the skill covers (compat-alias removal, controlled-state wiring) to round out specificity toward anchor 5.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Migrate preact Table v8 to v9', 'Audit framework construction, rendering, state, and app hooks', 'with shared API changes in the core migration skill' — with only minor gaps (verification, alias removal, and type-level work that the skill actually covers go unmentioned). It exceeds the 1-2 actions of anchor 3 but is not the comprehensive coverage of anchor 5.

4 / 5

Completeness

The 'what' is clear (migrate and audit a specific adapter across construction, rendering, state, and app hooks), but there is no 'Use when...' clause or equivalent trigger guidance anywhere. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

'migrate', 'preact Table', 'v8 to v9', 'rendering', 'state', and 'app hooks' are natural phrases a user would say, giving good keyword coverage. A few natural terms are missing — 'TanStack', 'upgrade', and the '@tanstack/preact-table' package name — so it falls short of anchor 5's synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

'preact Table v8 to v9' carves out a sharp niche — 'preact' distinguishes it from react/vue sibling migrations, and 'shared API changes in the core migration skill' explicitly delineates the boundary with the core skill rather than overlapping it. This matches anchor 5's clear niche with minimal conflict risk.

5 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

13

/

16

Passed

Repository

TanStack/table

Path

packages/preact-table/skills/migrate-v8-to-v9/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.