Name: devcontainer-management
Rating: 61.6 (1 reviews)
Author: netalertx

devcontainer-management

Guide for identifying, managing, and running commands within the NetAlertX development container. Use this when asked to run commands, testing, setup scripts, or troubleshoot container issues.

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/devcontainer-management/SKILL.md

Quality

Content

65%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 concise, actionable devcontainer skill with clean structure and good decision guidance. The main weakness is the missing validation checkpoint before the destructive setup.sh invocation and an over-detailed implementation note.

Suggestions

Add a pre-run validation step before invoking setup.sh (e.g., confirm the container ID is correct and warn that the script wipes /tmp and restarts services), forming a validate-then-execute feedback loop to lift workflow_clarity above 3.

Trim the long 'Note' paragraph about entrypoint.d internals and ALWAYS_FRESH_INSTALL; keep only the user-relevant safety fact (database/config preserved unless ALWAYS_FRESH_INSTALL=true) and let Claude read the script for the rest.

Optionally show how to resolve <CONTAINER_ID> into a shell variable (e.g., CID=$(docker ps -q -f name=netalertx)) so the example is fully copy-paste runnable.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with executable commands, but the long 'Note' paragraph explaining setup.sh internals (ramdisks, symlinking, entrypoint.d scripts, ALWAYS_FRESH_INSTALL behavior) over-explains implementation detail Claude could discover on demand.	3 / 5
Actionability	Provides concrete, copy-paste-ready commands ('docker ps --format ... \| grep netalertx', 'docker exec <CONTAINER_ID> bash .../setup.sh') with clear decision branches; minor gap is the placeholder <CONTAINER_ID> requires substitution.	4 / 5
Workflow Clarity	A clear find-then-run sequence exists with decision branches for zero/multiple containers, but setup.sh performs destructive actions (wipes /tmp, restarts services) with no validation or pre-check before running it, capping this at 3 per the destructive-operations rule.	3 / 5
Progressive Disclosure	A simple skill under 50 lines with no external bundle files; sections are well-organized ('Finding the Container', 'Running Commands') with clear headers, earning the full score per the simple-skill exception.	5 / 5
	Total	15 / 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 focused, well-structured description that clearly answers what the skill does and when to use it, anchored to a specific container. Minor gains possible from adding synonyms and clarifying 'managing'.

Dimension	Reasoning	Score
Specificity	Names several concrete actions — 'identifying, managing, and running commands within the ... development container' — but could be more comprehensive about what 'managing' entails.	4 / 5
Completeness	Has both a clear 'what' (guide for identifying/managing/running commands in the container) and an explicit 'when' ('Use this when asked to run commands, testing, setup scripts, or troubleshoot container issues'); the 'when' could be slightly more specific about container states.	4 / 5
Trigger Term Quality	Includes natural phrases users would say ('run commands', 'testing', 'setup scripts', 'troubleshoot container issues'); a few common synonyms like 'docker' or 'devcontainer' are missing.	4 / 5
Distinctiveness Conflict Risk	Scoped tightly to the 'NetAlertX development container', giving it a clear niche with distinct triggers and minimal conflict risk against other skills.	5 / 5
	Total	17 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: netalertx/NetAlertX
Path: .gemini/skills/devcontainer-management/SKILL.md
Commit: 014b960

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.