CtrlK
BlogDocsLog inGet started
Tessl Logo

shell-scripting

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

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./claude/skills/shell-scripting/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
einverne/dotfiles
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.