onboarding

How to register user-facing setup steps (API keys, OAuth, connecting third-party services) for the sidebar setup checklist. Use when adding a feature that needs initial user configuration.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, well-structured skill body with an executable example and clear sections. Nothing to improve on the measured dimensions.

Dimension	Reasoning	Score
Conciseness	A lean body with a focused rule, a complete code example, and related-skills pointers; it avoids padding and does not explain concepts Claude already knows.	3 / 3
Actionability	Provides a complete, executable registerOnboardingStep TypeScript example with imports, methods array, and an isComplete callback — copy-paste ready rather than pseudocode.	3 / 3
Workflow Clarity	A single-action skill whose registration step is unambiguous and shown concretely, organized into Rule, Registering a Step, and Related Skills sections; no destructive/batch operation requires a validation checkpoint.	3 / 3
Progressive Disclosure	Well-organized sections with one clearly signaled one-level-deep reference (packages/core/docs/content/onboarding.md) and no nested bundle references; under 50 lines with no monolithic content.	3 / 3
	Total	12 / 12 Passed

Description

75%

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 clear, complete description that pairs a concrete registration action with an explicit Use-when trigger in a distinct niche. Trigger phrasing is slightly formal and could be broadened with more natural user-facing terms.

Suggestions

Add natural trigger terms users would say, e.g. 'sign in', 'connect an account', or 'set up an integration'.

Consider listing multiple distinct actions (register a step, check completion, wire up OAuth) to push specificity toward the level-3 anchor.

Dimension	Reasoning	Score
Specificity	Names a concrete action 'register user-facing setup steps' with examples (API keys, OAuth, connecting third-party services), but it describes a single registration action rather than multiple distinct actions, so it stops short of the level-3 anchor.	2 / 3
Completeness	Clearly states what it does ('register user-facing setup steps ... for the sidebar setup checklist') and gives an explicit 'Use when adding a feature that needs initial user configuration' trigger, satisfying both what and when.	3 / 3
Trigger Term Quality	Relevant keywords like 'API keys', 'OAuth', 'connecting third-party services', and 'initial user configuration' are present, but the phrasing is somewhat technical and misses natural variations a user might actually say such as 'sign in' or 'connect an account'.	2 / 3
Distinctiveness Conflict Risk	The 'sidebar setup checklist' onboarding niche with its specific feature-configuration trigger is distinct and unlikely to conflict with other skills.	3 / 3
	Total	10 / 12 Passed

Validation

81%

Warnings & errors only

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

Validation — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	13 / 16 Passed

Repository: BuilderIO/agent-native
Path: .agents/skills/onboarding/SKILL.md
Commit: c1ee18b

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.