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

87%

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

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.

A dense, highly executable workflow: every step carries concrete commands, exact paths, or exact config values, with an End-state checklist and a Common-mistakes table anchoring correctness. The only structural gap is a missing explicit verification step (e.g., run/build the example and confirm nav rendering before opening the PR).

DimensionReasoningScore

Conciseness

The body is dense imperative prose with zero concept explanation — it uses terms like 'PKCE', 'BYOK', and 'Start routes' without padding, and every line either instructs or constrains ('Inline the model id... Do not add a model const, a chat-model.ts...'). Lean and efficient, matching the 5 anchor; the 4 anchor's 'minor instances of over-explanation' are absent.

5 / 5

Actionability

It provides copy-paste commands ('pnpm nx g @tanstack/workspace-plugin:react-app <slug>', 'npx @tanstack/cli@latest create'), exact file paths, exact config keys ('"tab": "tutorial"', 'framework/react/examples/<slug>'), a literal sandbox comment, the GitHub URL pattern, the dependency line, and a finished reference example (examples/react/basic-chat). The single dynamic step (model id) correctly instructs reading the adapter's current model list rather than hardcoding a time-sensitive value.

5 / 5

Workflow Clarity

A clear phased sequence (shape app → file layout → tutorial page → nav and pointers → PRs) with an End-state checklist and a Common-mistakes error-recovery table. However, there is no explicit validation checkpoint such as building or running the example before the PR, matching the 4 anchor 'clear sequence with most checkpoints present; minor validation gaps'; 5 would require an explicit validate-before-proceeding step.

4 / 5

Progressive Disclosure

The skill is a single well-sectioned file with no bundle files, stays lean, and delegates at precisely the right moments — 'Load docs, simple-english, and i-have-adhd before writing tutorial pages' and 'Load pr-description before gh pr create' — well-signaled, one level deep. Navigation is easy via its headers and the End-state summary; nothing inlined belongs in a separate file.

5 / 5

Total

19

/

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 trigger-first description with excellent 'when' guidance, including rare and valuable negative disambiguation against adjacent skills. Its weakness is the 'what': it names the deliverable ('adding a public teaching example or a docs tutorial') but never conveys the scope of work the skill orchestrates, leaving specificity at the mid-range.

Suggestions

Expand the 'what' with 2-3 concrete capability phrases, e.g. 'Generates a TanStack Start React example app, writes the matching docs tutorial page, wires it into docs navigation, and opens the PR. Use when adding a public teaching example or a docs tutorial...'

Add common positive trigger synonyms such as 'guide', 'walkthrough', or 'how-to' so the skill fires on the natural phrasings users reach for besides 'example' and 'tutorial'.

DimensionReasoningScore

Specificity

The description names the domain ('public teaching example or a docs tutorial') and a single action ('adding') but never states what the skill actually involves — app generation, tutorial writing, nav wiring, or PR creation. This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; not a 4 because no multi-action capability coverage is present, and not a 2 because the named actions are domain-specific rather than generic.

3 / 5

Completeness

The 'when' is explicit and unusually precise ('Use when adding a public teaching example or a docs tutorial', plus three negative cases), and a 'what' is present ('adding a public teaching example or a docs tutorial') but minimal — it names the deliverable without any scope of the work. Both what and when are answered with one side weaker, matching the 4 anchor; not 3 because the 'what' is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

It includes natural phrases a user would say — 'example', 'tutorial', 'docs tutorial', 'playground', 'API change', 'copy edit' — but omits common synonyms as positive triggers such as 'guide', 'walkthrough', or 'how-to'. Good coverage with a few natural terms missing fits the 4 anchor; 5 would require comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

It actively disambiguates against the nearest neighbors — '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' — establishing a clear niche with distinct triggers and minimal conflict risk, matching the 5 anchor.

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

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