setup
Setup Wizard — Configure environment for all skills
48
36%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./src/skills/bundled/setup/SKILL.mdQuality
Discovery
0%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 |
Implementation
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 |
Validation
90%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
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.