CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

environment-setup-guide

Guide developers through setting up development environments with proper tools, dependencies, and configurations

Quality

64%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/environment-setup-guide/SKILL.md

The canonical home for this skill is environment-setup-guide in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill body is highly actionable — concrete, executable commands throughout with a solid verify-then-troubleshoot flow — but it is bloated with installation knowledge Claude already possesses and buries everything in a single monolithic file with no progressive disclosure. The main quality lever is moving the worked examples and templates into reference files and cutting duplicated content.

Suggestions

Move the three worked examples (Node.js, Python, Docker) and the setup.sh template into references/ files (e.g. references/node-setup.md, references/python-setup.md, references/docker-setup.md) and keep only a compact quick-start workflow in SKILL.md — Claude already knows how to install Node, Python, and Docker via brew/apt/choco.

Remove duplicated content: the npm permission fix appears twice (Example 1 Troubleshooting and Common Pitfalls), and the Best Practices do/don't lists largely restate knowledge Claude already has.

Tighten the "How It Works" steps into concrete, conditional guidance (e.g. actual check commands with expected outcomes and decision branches) instead of descriptive summaries like "Provide Installation Instructions".

DimensionReasoningScore

Conciseness

The ~480-line body extensively spells out things Claude already knows — full Homebrew/Chocolatey installation instructions for Node, Python, and Docker, standard venv activation, docker-compose usage — and pads further with an emoji-decorated setup script, do/don't lists restating obvious practices, and a duplicated npm-permission fix (appearing in both Example 1's Troubleshooting and Common Pitfalls). This fits anchor 2 (noticeably verbose, several padded/unnecessary sections): worse than anchor 3's "mostly efficient with some tightening needed" given the sheer volume of redundant material, though not the pure concept-explanation padding of anchor 1 since commands are concrete.

2 / 5

Actionability

Everything is copy-paste ready: platform-specific install commands (brew, apt, choco, powershell), a full docker-compose.yml, .env file examples, a complete setup.sh script, and concrete troubleshooting commands (lsof -i :3000, kill -9, psql connection tests). The examples cover the three most common cases (Node, Python, Docker), matching anchor 5 exactly; there are no gaps that would drop it to anchor 4.

5 / 5

Workflow Clarity

The five-step process (identify requirements → check current setup → install → configure → verify) is clearly sequenced with an explicit verification step and a troubleshooting section providing feedback loops for common failures. This matches anchor 4 (clear sequence, most checkpoints present, minor gaps) rather than anchor 5 because the checkpoints in Steps 1-4 are somewhat generic descriptions ("Provide installation instructions", "Help set up") without explicit validate-and-retry loops baked into each step.

4 / 5

Progressive Disclosure

There are no bundle files at all — everything lives in one SKILL.md with decent section headers, but ~270 lines of full platform-specific examples plus the setup script template clearly belong in separate reference files. This matches anchor 3 (structure present, but content that should be separate is inline) rather than anchor 2 because the body is well-sectioned and navigable, and external links (nodejs.org, docs.docker.com) are clearly listed rather than buried.

3 / 5

Total

14

/

20

Passed

Description

50%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 clear and domain-appropriate but sits at the midpoint on every dimension: the action is generic, trigger variations are missing, and there is no "Use when" clause. It reads as a competent one-liner rather than an optimized trigger-rich description.

Suggestions

Add an explicit trigger clause, e.g. "Use when starting a new project, onboarding to a team, switching machines, or troubleshooting environment/dependency issues."

Replace generic phrasing with concrete actions: "Install languages and package managers, configure environment variables and dotfiles, and verify the setup" instead of "proper tools, dependencies, and configurations".

Include natural synonyms users would say — "dev environment", "environment setup", "onboarding", "new machine" — to improve trigger matching.

DimensionReasoningScore

Specificity

The description names the domain ("setting up development environments") and gestures at scope via "with proper tools, dependencies, and configurations", but the only real action is "Guide developers through setting up" — no concrete verbs like install, configure, or verify. This matches anchor 3 (domain plus 1-2 actions, not comprehensive) better than anchor 4, which expects several distinct specific actions; it is clearly above anchor 2 since the domain and objects are named rather than generic.

3 / 5

Completeness

The "what" is reasonably clear (guide developers through environment setup), but there is no "Use when..." clause or equivalent trigger guidance. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3, which is exactly this case: clear what, when entirely absent — not anchor 4, which requires both.

3 / 5

Trigger Term Quality

Natural terms like "development environments", "setup", "tools", and "dependencies" are present, but common variations users would actually say — "dev environment", "onboarding", "new machine", "install dependencies" — are missing. This fits anchor 3 (some relevant keywords, missing common variations and synonyms) rather than anchor 4's good coverage, and is well above anchor 2's purely generic keywords.

3 / 5

Distinctiveness Conflict Risk

"Setting up development environments with proper tools, dependencies, and configurations" is somewhat specific but very broad — it could overlap with project-specific setup skills, onboarding skills, or configuration-management skills. This matches anchor 3 (somewhat specific, still overlapping with similar skills) rather than anchor 4, which would require a tighter niche with more distinct triggers.

3 / 5

Total

12

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/environment-setup-guide/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.