Review, create, and validate Bash scripts when shell work needs strict mode, quoting safety, portability, or interpreter-compatible behavior.
53
60%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./Skills/agent-ops/bash-hygiene/SKILL.mdQuality
Discovery
85%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 is a well-crafted description that concisely communicates both what the skill does and when to use it. It uses third person voice correctly and lists specific, concrete capabilities. The main weakness is that trigger term coverage could be broader to capture more natural user phrasings like '.sh files' or 'shell scripting'.
Suggestions
Add common file extension triggers and user phrasing variations like '.sh files', 'shell scripting', 'bash syntax', or 'shellcheck' to improve trigger term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'Review, create, and validate Bash scripts' along with specific quality dimensions like 'strict mode, quoting safety, portability, interpreter-compatible behavior.' | 3 / 3 |
Completeness | Clearly answers both what ('Review, create, and validate Bash scripts') and when ('when shell work needs strict mode, quoting safety, portability, or interpreter-compatible behavior'). The 'when' clause is integrated naturally into the sentence with explicit trigger conditions. | 3 / 3 |
Trigger Term Quality | Includes 'Bash scripts' and 'shell' as natural keywords, plus technical terms like 'strict mode', 'quoting safety', and 'portability' that knowledgeable users would use. However, it misses common variations like '.sh files', 'shell scripting', 'shellcheck', 'bash syntax', or 'shebang' that users might naturally say. | 2 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to Bash/shell scripting with specific quality concerns (strict mode, quoting safety, portability), making it highly distinguishable from general coding skills or other language-specific skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable structural framework for Bash script review but critically lacks actionability — there are no concrete code examples, no sample shellcheck invocations, no example script reviews with before/after patches, and no executable commands. The workflow is described at a high level but remains abstract. The content reads more like a project charter or meta-policy document than an actionable skill that would help Claude perform Bash hygiene tasks.
Suggestions
Add concrete, executable examples: show a sample script with a quoting bug, the shellcheck command to detect it, and the corrected version as a before/after patch.
Include specific validation commands in the Workflow section, e.g., `shellcheck -s bash script.sh`, `bash -n script.sh` for syntax checking, with expected output formats.
Replace the abstract 'Examples' bullet points with full input/output examples showing a script review request and the expected findings/patch output format.
Consolidate 'Philosophy', 'Anti-Patterns', and 'Constraints' into a single concise 'Guidelines' section to reduce redundancy and improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some meta-commentary and philosophical framing ('Philosophy', 'Anti-Patterns') that Claude doesn't need. Sections like 'Avoid' and 'Anti-Patterns' overlap conceptually. The 'Inputs' and 'Outputs' sections are terse but read more like a schema stub than actionable guidance. | 2 / 3 |
Actionability | The skill lacks any concrete code, commands, or executable examples. The workflow is described abstractly ('Check strict mode, quoting, arrays, traps, paths, and temporary files') without showing what to check or how. The 'Examples' section lists use-case descriptions rather than input/output pairs with actual code. There is no shellcheck invocation example, no sample script review, and no copy-paste-ready commands. | 1 / 3 |
Workflow Clarity | The workflow section provides a reasonable sequence (identify shell, check issues, run shellcheck, report fixes) and the validation section includes a fail-fast gate. However, the steps are vague and lack explicit validation checkpoints with concrete commands. For a skill involving potentially destructive shell changes, the absence of specific validation commands and feedback loops caps this at 2. | 2 / 3 |
Progressive Disclosure | The skill references multiple external files (contract.yaml, evals.yaml, task-profile.json, deferred context directory) with clear paths, which is good structure. However, no bundle files were provided to verify these references exist, and the main content itself is thin enough that the references feel like they're compensating for missing substance rather than appropriately splitting detailed content. | 2 / 3 |
Total | 7 / 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 |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
d00c351
Table of Contents
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.