CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally lean, imperative skill body that assumes the model's competence and concentrates entirely on repo-specific procedure — commands, paths, config keys, and pitfalls are all concrete. The only gaps are an interim validation step in the workflow and a minor split of PR rules across two sections.

DimensionReasoningScore

Conciseness

Every line is an instruction or a repo-specific fact ('Inline the model id', 'Do not add `@tanstack/ai-client` (framework packages re-export the client)'), with zero concept explanations or padding — a direct match to anchor 5, 'every token earns its place'. Not 4 because there are no over-explanatory passages to trim.

5 / 5

Actionability

Guidance is copy-paste ready: the generator command (`pnpm nx g @tanstack/workspace-plugin:react-app <slug>`), exact file paths, config keys, the sandbox comment literal, and the GitHub link URL pattern. Anchor 5's 'specific examples cover the common cases' is met by the End state list and install-line spec; only trivial placeholders (<slug>) remain, which is appropriate.

5 / 5

Workflow Clarity

A clear, well-ordered sequence (shape the app → file layout → tutorial page → nav and pointers → PRs) is capped by an explicit 'End state' checklist, and the Common mistakes table acts as error-recovery guidance. It falls short of anchor 5 only because there is no interim validation step (e.g., build or run the example and verify tutorial code matches before opening the PR) — anchor 4's 'minor validation gaps'.

4 / 5

Progressive Disclosure

A single self-contained file with clear section headers, numbered steps, and a mistakes table — no nested references and nothing that clearly belongs in a separate file. It matches anchor 4 ('good structure, appropriately placed content') rather than 5 because at ~90 lines it exceeds the under-50-line single-file ideal and slightly overlaps sections (PR rules appear both in 'End state' and a separate 'PRs' section).

4 / 5

Total

18

/

20

Passed

Description

73%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 well-crafted trigger description with explicit 'Use when' guidance and unusually strong negative triggers that eliminate overlap with sibling skills. Its main weakness is that the 'what' side rests on one generic action, so a reader learns when to invoke it but not what it concretely does.

Suggestions

State 1-2 concrete capability actions after the trigger clause, e.g. 'Generates the example app with the Nx React generator, writes the tutorial page, wires nav entries, and opens a PR.'

Add common natural synonyms such as 'walkthrough' or 'sample app' to the trigger phrasing to catch users who do not say 'teaching example' or 'tutorial'.

Keep the negative triggers as-is — they are the description's strongest asset for distinctiveness.

DimensionReasoningScore

Specificity

The description names a specific domain ('adding a public teaching example or a docs tutorial') with one generic action ('adding'), but states none of the concrete capability actions the skill performs (generating the app, writing the tutorial, wiring nav, opening a PR). It matches anchor 3 — domain plus 1-2 concrete actions, not comprehensive — rather than 4, which requires several specific actions.

3 / 5

Completeness

The 'when' is explicit and specific ('Use when adding a public teaching example or a docs tutorial'), and a 'what' is present but thin — the task context implies the work without stating the capability actions. Both exist with one weaker side, matching anchor 4; it is not 5 because the 'what' lacks concrete capability phrases.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present ('adding a public teaching example', 'docs tutorial', 'Nx playground', 'package API change', 'copy edit'), and the negative triggers double as disambiguating keywords. A few natural synonyms ('walkthrough', 'how-to', 'sample app') are missing, so it fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Explicit carve-outs name the sibling skill and excluded cases ('an internal Nx playground (that is new-react-playground)', 'a package API change with no walkthrough', 'a docs-only copy edit'), giving a clear niche with minimal conflict risk — a direct match to anchor 5.

5 / 5

Total

16

/

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

Path

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