CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

getting-started

Create and render Table v9 with the octane adapter. Route reusable createTableHook components, and framework setup; use table-state for reactive ownership.

Quality

76%

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/octane-table/skills/getting-started/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 an exemplary lean overview: one complete executable example, terse adapter-specific gotchas, and clean one-level-deep routing to a verified reference file and type declarations. The only gap is that a couple of concrete directives (vite config, memoized inputs) lack accompanying code.

DimensionReasoningScore

Conciseness

The body is lean with no padding: a single complete setup example plus terse, non-obvious guidance ("Render `table.FlexRender` as a component so it gets its own Octane scope. It preserves numbers including `0`", "Keep features and column definitions at module scope"). Every statement carries information Claude would not already know about this adapter; it does not explain what tables or libraries are.

5 / 5

Actionability

The Setup section gives a complete, copy-paste-ready tsrx example (imports, column helper, keyed @for rendering, root mounting), and "API discovery" names exact files to inspect. It falls short of 5 because some concrete guidance is only directive — "Configure the consumer with `octane()` in `vite.config.ts`" and the `useMemo`/stable-data advice are given without the actual code, leaving the example not runnable as-is without unstated config.

4 / 5

Workflow Clarity

Sequencing is clear: "Load `intent load @tanstack/table-core#core` first" → Setup → construction rules → task-based routing → API discovery, and the "Read for the task" section maps each need (features, state, shared UI) to its resource. No validation checkpoints exist, but the skill involves no destructive or batch operations, so none are required; it is not a 5 because the steps are implied by section order rather than explicitly enumerated.

4 / 5

Progressive Disclosure

The body is a well-organized ~60-line overview with clearly signaled, one-level-deep references that resolve to real files: "read [create-table-hook](references/create-table-hook.md)" points at the actual references/create-table-hook.md, cross-skill routing goes to ../table-state/SKILL.md, and deep API detail is delegated to node_modules type declarations rather than inlined. Navigation is easy and content is appropriately split.

5 / 5

Total

18

/

20

Passed

Description

58%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.

The description is specific to its domain and mostly distinct, but it is written in internal jargon rather than natural trigger language and entirely lacks an explicit "when to use" clause. It communicates capability but not invocation conditions.

Suggestions

Add an explicit trigger clause such as "Use when setting up or rendering TanStack Table v9 tables in an Octane project, or when the user mentions octane-table, createTableHook, or table rendering in Octane."

Replace internal routing jargon with natural user-facing phrasing and synonyms (e.g., "set up a data table", "Octane", "TanStack Table", package name '@tanstack/octane-table') so the skill matches how users actually ask.

Fix the garbled second sentence ("Route reusable createTableHook components, and framework setup") so each capability is stated as a distinct, readable action.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Create and render Table v9 with the octane adapter", "Route reusable createTableHook components, and framework setup; use table-state for reactive ownership" — anchored in a specific library and version. It falls short of anchor 5 because coverage is not comprehensive (e.g., column definition, features, and data flow are not mentioned) and the phrasing "Route reusable createTableHook components, and framework setup" is awkward, slightly muddying what is actually offered.

4 / 5

Completeness

The "what" is clear (create and render Table v9 via the octane adapter, route reusable createTableHook components), but there is no "Use when..." clause or equivalent explicit trigger guidance; "use table-state for reactive ownership" routes to another skill rather than stating when to invoke this one. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords exist ("Table v9", "octane adapter", "createTableHook", "table-state", "reactive ownership") but they skew toward internal jargon and hook names rather than phrases a user would naturally say. Missing natural variations and synonyms — "TanStack" never appears, nor do user-level phrases like "set up a table", "build a data grid", or file/package extensions.

3 / 5

Distinctiveness Conflict Risk

The octane adapter, Table v9, and createTableHook naming carve out a fairly distinct niche with minimal overlap against unrelated skills. It stays at 4 rather than 5 because "Create and render Table" is a pattern other table-framework adapter skills could also match, so a minor overlap risk remains.

4 / 5

Total

14

/

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: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

TanStack/table

Path

packages/octane-table/skills/getting-started/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.