CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

netalertx-idempotent-setup

Reprovision and reset the devcontainer environment. Use this when asked to re-run startup, reprovision, setup devcontainer, fix permissions, or reset runtime state.

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A tight, highly actionable single-command skill with excellent progressive disclosure for its size. The one real gap is the absence of any post-run verification in a destructive workflow, which caps workflow clarity, and the Philosophy section is mildly redundant with the intro.

Suggestions

Add a verification step after running setup.sh (e.g. check that php-fpm/nginx/crond processes are running and .VERSION was written) to lift the destructive-workflow cap on workflow clarity.

Merge the 'Philosophy' section into the intro paragraph or trim it to one sentence, since it repeats the same unconditional-reset / ALWAYS_FRESH_INSTALL point made twice elsewhere.

State how to run a full reset (e.g. 'ALWAYS_FRESH_INSTALL=true /workspaces/NetAlertX/.devcontainer/scripts/setup.sh') so the destructive variant is copy-paste ready too.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: an exact command, a compact step list, and no explanation of concepts Claude already knows. It falls short of 5 because the 'Philosophy' section largely restates the intro paragraph's point that runtime state is reset unconditionally while /data is preserved.

4 / 5

Actionability

The skill gives a fully executable, copy-paste-ready command ('/workspaces/NetAlertX/.devcontainer/scripts/setup.sh') plus a concrete eight-step account of what it does, including the exact env var gate ('ALWAYS_FRESH_INSTALL=true') and script names ('entrypoint.d/25-first-run-db.sh', '20-first-run-config.sh'). This covers the common cases completely.

5 / 5

Workflow Clarity

The single-action workflow is unambiguous and the script's internal steps are well enumerated, but this is a destructive operation (kills all services, wipes runtime state) with no validation or verification step after running it, and the rubric explicitly caps destructive skills without validation at 3. It is not 2 because the sequence and side effects are clearly stated.

3 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, requires no external references, and is organized into clear well-labeled sections (Command, What It Does, When to Use, Philosophy). Per the simple-skill exception, this matches the top anchor.

5 / 5

Total

17

/

20

Passed

Description

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

A strong description with an explicit 'Use this when' trigger clause and mostly natural trigger terms in third-person voice. Its main weakness is specificity: it summarizes the skill as 'reprovision and reset' without naming the concrete actions involved.

Suggestions

Enumerate 1-2 more concrete capabilities in the what-clause, e.g. 'Kills and restarts services, remounts tmpfs ramdisks, recreates symlinks and log files' to raise specificity from 3.

Add common user phrasings such as 'restart the environment' or 'environment is broken' to broaden trigger term coverage.

Narrow or contextualize 'fix permissions' (e.g. 'fix devcontainer file permissions') to reduce overlap risk with generic permission-fixing skills.

DimensionReasoningScore

Specificity

The description names the domain (devcontainer) and two concrete actions ('Reprovision and reset the devcontainer environment') but does not enumerate what is actually reset (services, tmpfs ramdisks, symlinks, logs), so coverage is not comprehensive. It sits at the 'names domain and 1-2 concrete actions' anchor, not 4 because several specific actions are missing.

3 / 5

Completeness

It clearly answers both what ('Reprovision and reset the devcontainer environment') and when, with an explicit 'Use this when asked to...' clause listing concrete trigger phrases. This matches the top anchor exactly.

5 / 5

Trigger Term Quality

're-run startup, reprovision, setup devcontainer, fix permissions, or reset runtime state' provides good natural keyword coverage including phrases users would say. It falls short of 5 because common variations like 'restart services' or 'broken environment' are absent.

4 / 5

Distinctiveness Conflict Risk

The devcontainer reprovision niche is mostly distinct with dedicated triggers (reprovision, setup devcontainer), but 'fix permissions' is generic enough to risk overlap with unrelated skills. Not 5 due to that minor overlap risk; clearly above 3 because the core triggers are specific to this skill.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

netalertx/NetAlertX

Path

.github/skills/devcontainer-setup/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.