CtrlK
BlogDocsLog inGet started
Tessl Logo

start

First-time onboarding — asks where you are, then guides you to the right workflow.

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/start/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a highly actionable, well-sequenced onboarding script — every phase has copy-paste prompts, explicit mappings, approval gates, and decline/edge-case handling. Its weakness is token weight: ~410 lines carrying substantial design-rationale commentary and repeated cross-phase instructions that belong in a reference file, which also leaves progressive disclosure with no bundle to offload to.

Suggestions

Move the design-rationale blockquotes (the modes.review_mode resolution note, 'Why this is asked here' paragraphs, tier-neutrality explanations) into a single references/design-notes.md, leaving one-line pointers in the body — this trims conciseness padding and creates real progressive disclosure structure.

Consolidate the four near-identical 'Name the immediate next step only' instructions (Paths A–D) into one shared rule stated once before the routing section.

Add a short validation step after the Phase 3c/3d/3e writes — e.g. re-read project.yaml to confirm the stage, rigor, and automation keys landed where expected — so the write phases close the loop the way the interactive phases do.

DimensionReasoningScore

Conciseness

Nearly every sentence carries project-specific directives Claude could not infer (option labels, value mappings, file write rules), so it is not explaining known concepts — but lengthy rationale blockquotes (the modes.review_mode resolution note, the two "Why this is asked here" paragraphs, the tier-neutrality notes) and the "Name the immediate next step only" instruction repeated verbatim across four paths inflate the token budget. Fits 'Mostly efficient but includes some unnecessary explanation or could be tightened', not 2 (padding is rationale, not fluff) nor 4 (several multi-paragraph design-rationale blocks could be condensed or moved out of line).

3 / 5

Actionability

Fully executable for an instruction-only skill: exact AskUserQuestion prompts and option labels, explicit option-to-value mappings, a copy-paste v1.1 project.yaml template, a stage mapping table, and prescribed reply lines for every phase. Matches 'Fully executable; copy-paste ready… specific examples cover the common cases'; edge cases are enumerated with concrete responses.

5 / 5

Workflow Clarity

Phases 1–5 are clearly sequenced with explicit checkpoints: silent pre-detection before asking, an ask-before-write approval in Phase 3c that explicitly covers the 3d/3e writes, decline handling carried forward, skip-if-already-set checks for rigor and automation, a mismatch trigger, an empty-project/D-but-empty edge case, and a terminal verdict. Matches 'Clear sequence with explicit validation steps; feedback loops…; checklists for complex processes'.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the body is a ~410-line monolith whose design-rationale blockquotes and repeat-routing rules could live in a reference file. External .claude/docs references are well signaled (one level deep, with per-section token-cost warnings), which lifts it above 2, but inline rationale that clearly belongs in a separate file caps it at 'Some structure but could be better organized', short of 4.

3 / 5

Total

16

/

20

Passed

Description

62%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 concise, third-person, and honestly scoped, with a stated 'when' (first-time onboarding) — but its action coverage and trigger vocabulary are thin. It routes rather than describes, and a user searching with everyday phrases like "getting started" or "new project" may not surface it.

Suggestions

List the concrete actions the skill performs — e.g. 'asks where you are, sets project stage and rigor/automation settings in project.yaml, and routes to the right workflow' — to raise specificity beyond two generic verbs.

Add an explicit trigger clause and everyday synonyms, e.g. 'Use when a new user first opens the project, asks to get started, or wants onboarding guidance.'

Include one or two natural trigger terms users actually type ("getting started", "new here", "first game") so the description surfaces on those phrasings.

DimensionReasoningScore

Specificity

Names the domain (onboarding) and two concrete actions — "asks where you are, then guides you to the right workflow" — but stops there; it never names which workflows it routes to or what it actually does (questionnaire, config writes, path presentation). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive', not 4, which requires several specific actions.

3 / 5

Completeness

The 'what' is clear (asks where the user is, then guides them to the right workflow) and the 'when' is stated up front via "First-time onboarding" rather than merely implied, but it lacks an explicit "Use when…" trigger clause, so it fits 'Has both what and when; when could be more explicit or specific'. Not 5: no concrete trigger phrase like 'Use when a new user starts their first session'.

4 / 5

Trigger Term Quality

"First-time onboarding" is a natural phrase a new user might echo, but it is essentially the only trigger keyword; common variations like "getting started", "new project", "set up my project", or "where do I begin" are absent. Matches 'Some relevant keywords but missing common variations or synonyms', short of 4's 'Good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"First-time onboarding" carves a distinct niche versus sibling skills like /brainstorm or /setup-engine, and the routing framing differentiates it from generic /help. Minor overlap risk remains with other orientation/entry-point skills, matching 'Mostly distinct; minor overlap risk with closely related skills' rather than a fully conflict-free 5.

4 / 5

Total

14

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
Donchitos/Claude-Code-Game-Studios
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.