CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-bash-scripts

Bash script style guide. Always use when writing bash scripts, shell scripts, or CLI bash tools.

Quality

80%

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 ./.agents/skills/writing-bash-scripts/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

The body is an exemplary lean style guide: concrete, directive, and entirely free of padding. Its only gaps are the absence of a short worked example script and slightly under-specified judgment rules like "minimal input validation".

DimensionReasoningScore

Conciseness

Seven lean directive bullets ("Use `#!/usr/bin/env bash` as shebang", "Always use `set -euo pipefail` for safety") with zero padding and no explanation of concepts Claude already knows. Every token earns its place, matching the lean-and-efficient anchor exactly.

5 / 5

Actionability

Mostly concrete and executable guidance: exact commands (`set -euo pipefail`, `chmod +x <script>`) and specific behaviors ("print usage to stderr and exit if inputs are missing/invalid"). It stops short of fully copy-paste-ready coverage because no complete example script shows the rules applied together and input-validation guidance lacks a concrete pattern.

4 / 5

Workflow Clarity

As a simple single-purpose style guide, each rule is an unambiguous directive, so clarity is high. However, "Minimal input validation" and "if failure is obvious on use" leave judgment calls without illustrative examples, keeping it below the fully unambiguous level 5.

4 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained, needs no external references (and none exist in the bundle), and is organized as a clean headed bullet list. Per the simple-skill guideline, this earns full credit for structure and navigability.

5 / 5

Total

18

/

20

Passed

Description

65%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.

The description has a clear, explicit trigger clause and natural keywords, but the capability statement is a bare domain label rather than a list of concrete actions. It is functional and concise, yet a user scanning it learns little about what the style guide actually enforces.

Suggestions

Replace the bare "Bash script style guide" label with 2-3 concrete capabilities, e.g., "Enforces shebang, strict mode (set -euo pipefail), minimal validation, and executable-script conventions for bash scripts."

Add file-extension and variation triggers such as ".sh files", "shell scripting", or "bash one-liners" to broaden natural keyword coverage.

Briefly signal scope boundaries (e.g., "Applies to standalone scripts, not interactive shell sessions") to reduce overlap with general shell-command skills.

DimensionReasoningScore

Specificity

"Bash script style guide" names the domain but enumerates no concrete capabilities or actions, matching the anchor "Names the domain but actions are minimal or generic". It falls short of 3 because it never lists what the guide covers (e.g., shebangs, strict mode, error handling) and above 1 because the domain is clearly identified.

2 / 5

Completeness

Both parts are present: "Bash script style guide" states the what, and "Always use when writing bash scripts, shell scripts, or CLI bash tools" is an explicit when clause with concrete triggers. The what is thin (no summary of what the style guide governs), keeping it below the fully explicit anchor 5.

4 / 5

Trigger Term Quality

"bash scripts, shell scripts, or CLI bash tools" provides good natural-phrase coverage with synonyms users would actually say. It misses file extensions (.sh) and common variations like "shell scripting" or "bash one-liners", so it does not reach the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The bash/shell scripting niche is clear and the triggers are distinct from unrelated skills, with only minor overlap risk against general coding-style or other shell-language skills. It is not a 5 because adjacent skills (general shell commands, zsh) could plausibly compete for the same triggers.

4 / 5

Total

14

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

saski/arnesto

Path

.agents/skills/writing-bash-scripts/SKILL.md

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.