setup

Setup Wizard — Configure environment for all skills

Quality

36%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./src/skills/bundled/setup/SKILL.md

Quality

Content

72%

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

This is a clean, well-structured reference for a setup wizard with good conciseness and organization. However, it lacks example outputs showing what the wizard displays, and the workflow could benefit from explicit validation/error-recovery guidance (e.g., what happens when a health check fails, how to verify a category is properly configured).

Suggestions

Add an example output snippet showing what `/setup` or `/setup check` displays, so Claude knows the expected format and can replicate it.

Add error-recovery guidance: what should happen when `/setup check` finds issues, and how to verify successful configuration after setting environment variables.

Dimension	Reasoning	Score
Conciseness	The content is lean and efficient. No unnecessary explanations of what a setup wizard is or how environment variables work. Every section earns its place.	3 / 3
Actionability	The commands are concrete and copy-paste ready, but the skill itself is a reference for slash commands rather than providing executable code or showing what the wizard actually outputs. There are no example outputs or concrete configuration steps beyond 'run this command'.	2 / 3
Workflow Clarity	The 'How It Works' section describes the wizard's behavior but doesn't provide a clear user workflow with validation checkpoints. For a setup/configuration skill, there's no guidance on what to do if checks fail or how to verify successful configuration.	2 / 3
Progressive Disclosure	For a simple skill under 50 lines, the content is well-organized with clear sections: Quick Start, Commands reference table, and How It Works. The structure is appropriate for the scope.	3 / 3
	Total	10 / 12 Passed

Description

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is extremely vague and provides almost no useful information for skill selection. It lacks concrete actions, natural trigger terms, explicit 'when to use' guidance, and is so generic it would conflict with many other skills. It reads more like a label than a functional description.

Suggestions

List specific concrete actions the skill performs, e.g., 'Installs dependencies, sets environment variables, creates configuration files, and validates tool availability.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to set up their project, initialize the environment, install prerequisites, or when a skill reports missing dependencies.'

Narrow the scope to reduce conflict risk — specify what kind of environment configuration (e.g., Python virtualenvs, Node.js packages, Docker containers) or clarify the relationship to other skills.

Dimension	Reasoning	Score
Specificity	The description uses vague language — 'configure environment' is abstract and does not list any concrete actions like installing dependencies, setting environment variables, or creating config files.	1 / 3
Completeness	The description vaguely addresses 'what' (configure environment) but provides no 'when' clause or explicit trigger guidance. Both aspects are very weak.	1 / 3
Trigger Term Quality	'Setup Wizard' and 'configure environment' are not natural phrases a user would say. Users might say 'set up my project', 'install dependencies', 'initialize', or 'configure settings' — none of which are covered here.	1 / 3
Distinctiveness Conflict Risk	'Configure environment for all skills' is extremely generic and could conflict with any skill that involves setup, configuration, installation, or initialization tasks.	1 / 3
	Total	4 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: alsk1992/CloddsBot
Commit: e71a5f6

Reviewed: 2 months 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.