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.

63

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./claude/skills/shell-scripting/SKILL.md
SKILL.md
Quality
Evals
Security

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 highly actionable reference packed with executable, copy-paste-ready shell examples. Its weaknesses are conciseness (much is generic knowledge Claude already has) and progressive disclosure (everything is inlined in one file with no references).

Suggestions

Trim the 'Core Competencies' and 'Best Practices' bullets that restate shell fundamentals Claude already knows; keep only non-obvious guidance to improve conciseness.

Move the full safe-script template and the 'Common Patterns' catalog into a separate references/ file (e.g., references/patterns.md) and link to it from SKILL.md to enable progressive disclosure.

If the skill is meant to guide script creation end-to-end, add an explicit numbered workflow with a validation/syntax-check checkpoint (e.g., 'bash -n script.sh' before running) to raise workflow clarity.

DimensionReasoningScore

Conciseness

The form is tight (bullets and code, little prose padding), but large portions restate generic shell best practices Claude already knows ('Quote variables', 'Use [[ for conditionals', 'Avoid parsing ls output'), so several sections could be trimmed without losing value.

3 / 5

Actionability

Provides copy-paste-ready, fully executable examples covering common cases — a complete safe-script template, command-existence check, null-delimited file loop, trap-based error handling, colored output, and read prompts.

5 / 5

Workflow Clarity

This is a reference/knowledge skill with no multi-step workflow; the safe-script template implies an implicit order (shebang → set → functions → parse args → main) but there are no explicit validation checkpoints or feedback loops.

3 / 5

Progressive Disclosure

Content is well-sectioned with clear headers but is entirely inline in a ~165-line SKILL.md with no bundle files or one-level-deep references; material like the full template and pattern catalog could be split into reference files to aid navigation.

3 / 5

Total

14

/

20

Passed

Description

83%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, concrete 'Use when...' trigger clause and natural user-facing keywords. The main weakness is a knowledge-oriented 'what' sentence that names capabilities rather than concrete actions.

DimensionReasoningScore

Specificity

The 'when' clause names three concrete actions ('write, debug, or optimize shell scripts'), though the lead 'what' sentence is capability-naming ('Specialized knowledge of...') rather than action verbs, leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both 'what' (specialized knowledge of Bash/Zsh scripting, automation, CLI tools, best practices) and 'when' with a concrete 'Use when the user needs to write, debug, or optimize shell scripts or work with command-line tools' trigger clause.

5 / 5

Trigger Term Quality

Natural terms users would say are well covered ('shell scripts', 'command-line tools', 'write, debug, or optimize'), with good keyword density; a few synonyms (e.g., 'bash scripts', '.sh') are absent, keeping it just below comprehensive.

4 / 5

Distinctiveness Conflict Risk

The Bash/Zsh scripting niche is mostly distinct with clear triggers, but the broad phrase 'command-line tools' creates minor overlap risk with general-purpose or tooling skills.

4 / 5

Total

17

/

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.

Validation16 / 16 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.