CtrlK
BlogDocsLog inGet started
Tessl Logo

add-example-tutorial

Use when adding a public teaching example or a docs tutorial. Don't use for an internal Nx playground (that is new-react-playground), for a package API change with no walkthrough, or for a docs-only copy edit.

59

Quality

74%

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 ./.claude/skills/add-example-tutorial/SKILL.md

The canonical home for this skill is add-example-tutorial in TanStack/ai

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, highly actionable procedural guide with a clear multi-step workflow, an end-state checklist, and an error-recovery table — it assumes Claude's competence and avoids concept padding. The main gap is the absence of an explicit build/run validation checkpoint before the PR step.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout, assuming Claude's competence (no padding about what Nx, TanStack Start, or adapters are) and every line carries instruction. It does not reach 5 because a few enumerated lists and the End-state/Common-mistakes sections could be tightened further, landing at 'efficient; minor instances of over-explanation that could be trimmed'.

4 / 5

Actionability

Concrete commands ('pnpm nx g @tanstack/workspace-plugin:react-app <slug>', 'npx @tanstack/cli@latest create'), exact file paths, and a copy-paste sandbox comment make this mostly executable. It stops short of 5 because some steps are conditional/abstract ('Open with the problem the reader has', 'Add other files only when this tutorial needs them'), leaving minor gaps in fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

A clear numbered sequence (Shape the app -> File layout -> Tutorial page -> Nav and pointers -> PRs) with an End-state checklist and a Common-mistakes error-recovery table gives most checkpoints. It does not reach 5 because there is no explicit run/build validation step before opening the PR, leaving a minor validation gap rather than the full validate->fix->retry loop.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so the skill is self-contained and well-sectioned into clearly labeled parts with one-level-deep load directives ('Load docs, simple-english, and i-have-adhd'). Structure is good and content is appropriately placed, matching 'good structure; most content appropriately placed; minor organization gaps' rather than the perfect split-and-navigate pattern of a 5.

4 / 5

Total

16

/

20

Passed

Description

61%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 strong on trigger guidance and conflict avoidance — the 'Use when' clause and explicit don't-use-for boundaries are exemplary — but the 'what' is underspecified, naming only a single generic action. It reads more as a routing rule than a capability statement.

Suggestions

Add 1-2 concrete actions to the 'what' so the description states what the skill does, not just when to route to it — e.g. 'Generates a TanStack Start React example app, slims it to one scenario, writes the docs tutorial page, and wires nav/PR.'

Broaden trigger-term coverage with synonyms users actually say ('walkthrough', 'guide', 'demo', 'sample') alongside 'example' and 'tutorial'.

Keep the negative-boundary clause; it is the strongest part of the description and should stay even if the rest is expanded.

DimensionReasoningScore

Specificity

The description names the domain ('adding a public teaching example or a docs tutorial') but the only action verb is the generic 'adding', with no enumeration of the concrete steps the skill actually performs (generate app, slim, write tutorial, wire nav, open PR). It sits just below the midpoint: more than a bare domain label (which would be a 1) but only one minimal/generic action rather than the 1-2 concrete actions needed for a 3.

2 / 5

Completeness

Both what ('adding a public teaching example or a docs tutorial') and when ('Use when adding...') are present and explicit, plus negative trigger boundaries. It does not reach 5 because the 'what' stays abstract (a single generic verb) rather than stating concrete actions, leaving the 'when' more explicit than the 'what'.

4 / 5

Trigger Term Quality

Natural terms 'example', 'tutorial', and 'docs' appear and a user might say 'add a tutorial', but coverage is thin — no synonyms or variations like 'walkthrough', 'guide', 'sample', or 'demo'. This matches 'some relevant keywords but missing common variations or synonyms' rather than the broad coverage of a 4.

3 / 5

Distinctiveness Conflict Risk

Explicit negative boundaries ('Don't use for an internal Nx playground (that is new-react-playground), for a package API change with no walkthrough, or for a docs-only copy edit') carve out a clear niche and directly disambiguate from sibling skills, giving minimal conflict risk as the anchor for 5 describes.

5 / 5

Total

14

/

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
TanStack/ai
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.