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.

72

Quality

90%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 instruction skill: fully concrete commands and paths, an explicit end-state contract, ordered phases, and a mistakes table, with no filler. Its single gap is the absence of an explicit pre-PR verification step, which keeps workflow clarity just short of the top anchor.

DimensionReasoningScore

Conciseness

Every line is an instruction, a constraint, or a pointer ('The route file owns `chat()`', 'Do not add BYOK files by default') with zero padding and no explanation of concepts Claude already knows. It assumes competence throughout and matches the 'lean and efficient; every token earns its place' anchor rather than the 4 anchor, which would require trimmable over-explanation.

5 / 5

Actionability

Guidance is copy-paste ready throughout: the exact generator command ('pnpm nx g @tanstack/workspace-plugin:react-app <slug>'), exact paths ('examples/react/<slug>/', 'src/routes/api.chat.ts'), the sandbox comment template, the config child ('framework/react/examples/<slug>'), and the GitHub link format. It matches the 5 anchor — executable commands covering the common cases; a 4 would imply missing key details, and none are evident.

5 / 5

Workflow Clarity

The sequence is explicit and well-ordered (shape the app → file layout → tutorial page → nav and pointers → PRs) with an upfront 'End state' checklist, a 'Common mistakes' diagnosis table, and one honesty gate ('Do not tick test:pr if it was not run'). It falls short of 5 because there is no explicit build/run validation checkpoint before opening the PR (e.g., verifying the example builds or the tutorial page renders), leaving verification implicit rather than a feedback loop.

4 / 5

Progressive Disclosure

The skill is a single well-organized file with clear section headers, an end-state checklist, and a mistakes table; no bundle files exist (references/, scripts/, assets/ are absent), and detail is appropriately delegated to named sibling skills ('Load `docs`, `simple-english`, and `i-have-adhd`') which are one level deep and clearly signaled. Navigation is easy and nothing that belongs in a separate file is inlined, so it sits at the 5 anchor rather than 4's 'minor organization gaps'.

5 / 5

Total

19

/

20

Passed

Description

82%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 explicit, terse, and highly disambiguated: it states what the skill does, when to use it, and three explicit exclusions that prevent triggering for neighboring skills. Its only weakness is that it summarizes rather than enumerates the underlying capabilities, which limits specificity.

DimensionReasoningScore

Specificity

The description names its domain ('adding a public teaching example or a docs tutorial') but offers no breakdown of the concrete actions involved (generating the app, slimming it, writing the tutorial page, wiring nav/config), placing it at 'domain plus 1-2 actions, not comprehensive'. It is above a 2 because 'adding a public teaching example' is a concrete, specific action rather than a generic one, but below a 4 because no multi-action capability list is present.

3 / 5

Completeness

It explicitly answers what ('adding a public teaching example or a docs tutorial') and when ('Use when adding a public teaching example or a docs tutorial'), with concrete trigger phrasing plus explicit negative triggers ('Don't use for an internal Nx playground..., a package API change with no walkthrough, or a docs-only copy edit'). This matches the 5 anchor on both explicit what and when with concrete triggers; a 4 would require the when to be less specific than it is.

5 / 5

Trigger Term Quality

Natural user phrases like 'adding a public teaching example', 'docs tutorial', and 'walkthrough' are present and would match how a user asks for this. A 5 would require broader synonym/extension coverage (e.g., 'guide', 'how-to', 'sample app'), and it is clearly above 3 because several common natural terms are already covered.

4 / 5

Distinctiveness Conflict Risk

The description actively disambiguates against three named sibling scenarios (internal Nx playground → new-react-playground, package API change without walkthrough, docs-only copy edit), giving it a clear niche with minimal conflict risk. It is not a 4 because no overlap risk remains unspecified — the exclusions cover the plausible confusions directly.

5 / 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
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.