Specialized knowledge of Bash and Zsh scripting, shell automation, command-line tools, and scripting best practices. Use when the user needs to write, debug, or optimize shell scripts or work with command-line tools.
80
Quality
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./claude/skills/shell-scripting/SKILL.mdQuality
Discovery
89%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 solid skill description with explicit 'Use when' guidance and good trigger term coverage for shell scripting tasks. The main weakness is that the capabilities section could be more specific about concrete actions beyond the generic 'write, debug, or optimize'. Overall, it effectively distinguishes itself and would help Claude select this skill appropriately.
Suggestions
Add more specific concrete actions like 'parse command-line arguments', 'handle signals', 'create pipelines', or 'write cron jobs' to improve specificity
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Bash/Zsh scripting, shell automation, command-line tools) and mentions actions (write, debug, optimize), but lacks specific concrete actions like 'parse arguments', 'handle signals', or 'create cron jobs'. | 2 / 3 |
Completeness | Clearly answers both what ('Specialized knowledge of Bash and Zsh scripting, shell automation, command-line tools, and scripting best practices') and when ('Use when the user needs to write, debug, or optimize shell scripts or work with command-line tools'). | 3 / 3 |
Trigger Term Quality | Good coverage of natural terms users would say: 'Bash', 'Zsh', 'shell scripts', 'command-line tools', 'scripting'. These are terms users naturally use when seeking help with shell scripting. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on shell scripting (Bash/Zsh) with distinct triggers. Unlikely to conflict with general coding skills or other language-specific skills due to explicit shell/command-line focus. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid reference skill with excellent actionable code examples that are immediately executable. However, it reads more like a cheat sheet than a skill guide, with some unnecessary explanations of concepts Claude already knows. The lack of workflow guidance for script development/debugging and the monolithic structure prevent it from scoring higher.
Suggestions
Remove explanatory text for concepts Claude already knows (e.g., 'Proper shebang usage', basic quoting rules) and keep only the concrete examples
Add a brief workflow section for script development: write -> shellcheck -> test -> iterate
Consider splitting Zsh-specific features and security considerations into separate reference files with clear links from the main skill
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some unnecessary explanations Claude would already know (e.g., explaining what 'shebang' means, basic concepts like 'Quote variables'). The lists of best practices and competencies could be tighter. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready code examples throughout. The safe script template, common patterns (command existence check, file loops, error handling, colored output, user input) are all concrete and immediately usable. | 3 / 3 |
Workflow Clarity | While individual patterns are clear, there's no explicit workflow for script development or debugging. The content is organized as reference material rather than a guided process. For a reference-style skill this is acceptable, but validation checkpoints for script testing are missing. | 2 / 3 |
Progressive Disclosure | Content is organized into logical sections with headers, but it's a monolithic document with no references to external files for advanced topics. The Zsh-specific features and security considerations could be split into separate files for better organization. | 2 / 3 |
Total | 9 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
b1b2fe0
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.