CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bash-linux

Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.

Quality

69%

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

Quality

Content

53%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 well-organized, highly concrete quick-reference whose main liability is token efficiency: roughly half the sections tabulate basics Claude already knows, and the generic When to Use/Limitations boilerplate adds no value. Actionability is strong throughout, but the reference format lacks explicit multi-step workflows with validation checkpoints, and genuinely platform-divergent details are flagged rather than shown.

Suggestions

Cut or drastically compress sections covering absolute basics (operator chaining table, `ls`/`cat`/`head`/`tail`, `env`/`export`, basic curl) and keep only what adds non-obvious value, such as the macOS/GNU divergences and safe-scripting patterns.

Replace the flagged-but-unshown platform differences with the actual commands (e.g., `sed -i ''` on macOS vs `sed -i` on GNU) so the guidance is executable without outside lookup.

Remove the generic 'When to Use' and 'Limitations' boilerplate sections, which restate template language and add no bash-specific guidance.

DimensionReasoningScore

Conciseness

Although presented in compact tables, several sections restate basics Claude already knows cold — the operator chaining table, `ls -la`, `cat file.txt`, `head`/`tail`, `ps aux`, `export VAR="value"`, and generic curl usage — and the boilerplate 'When to Use'/'Limitations' sections add pure padding. This matches 'several unnecessary explanations or padded sections' (2) rather than 3, since the unnecessary content spans multiple sections, but not 1 because there is no verbose prose explaining concepts.

2 / 5

Actionability

The body is packed with concrete, mostly copy-paste-ready commands and a complete executable script template (`set -euo pipefail`, logging functions, trap cleanup). Minor gaps keep it at 4 rather than 5: the curl POST row uses a literal `URL` placeholder, and the `sed` row notes in-place flags 'differ on macOS/GNU' without showing the actual flags for each platform.

4 / 5

Workflow Clarity

This is a reference cheat-sheet rather than a sequenced multi-step process, so workflows are implicitly organized by task-oriented tables rather than explicit steps with checkpoints. Validation cues appear in places ('verify exit, escalate only if necessary', 'verify ownership before stopping', the note that `set -e` has exceptions), but there is no explicit validate-then-proceed or fix-and-retry loop anywhere, matching the 'sequence/checkpoints partial' middle anchor.

3 / 5

Progressive Disclosure

No bundle files exist, and the ~200-line body is a cohesive quick-reference appropriately kept inline, organized into ten clearly headed, consistently formatted sections. This matches 'good structure; most content is appropriately placed; minor organization gaps'; it is not 5 because there are no one-level-deep references for genuinely deeper material (e.g., sed/awk platform differences) and section ordering mixes reference tables with pattern recipes.

4 / 5

Total

13

/

20

Passed

Description

71%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 concise, third-person description that clearly names the domain and several concrete capability areas and includes an explicit 'Use when' clause. Its main weaknesses are the overly broad trigger condition — 'when working on macOS or Linux systems' matches almost any task on those platforms — and missing common trigger synonyms like 'shell', 'command line', or 'CLI'.

Suggestions

Tighten the 'Use when' clause to fire on terminal/shell-specific contexts (e.g., 'Use when writing shell scripts, running terminal commands, or piping commands on macOS or Linux') instead of any work on those systems.

Add natural trigger synonyms such as 'shell', 'command line', 'CLI', and 'sh/zsh' to improve trigger coverage and distinctiveness.

DimensionReasoningScore

Specificity

The description lists several specific capability areas — "Critical commands, piping, error handling, scripting" — beyond just naming the domain, matching the 'several specific actions; minor gaps in coverage' anchor. It falls short of 5 because coverage has gaps (no mention of process management, text processing, or environment setup) and the items are topic nouns rather than concrete actions.

4 / 5

Completeness

Both 'what' ("Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting.") and 'when' ("Use when working on macOS or Linux systems") are explicitly present. The 'when' clause could be more specific — it scopes to any work on those systems rather than terminal/shell tasks — matching the anchor 4 example ('Use when working with PDF files') rather than the concrete-trigger-phrases of 5.

4 / 5

Trigger Term Quality

Natural trigger terms are present — "Bash", "Linux", "terminal", "commands", "scripting", "macOS" — giving good keyword coverage users would actually say. A few common natural terms are missing (e.g., 'shell', 'command line', 'CLI', 'zsh'), which fits the 'good coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The 'what' carves a distinct niche (bash terminal patterns, piping, scripting), but the trigger "Use when working on macOS or Linux systems" is broad enough to overlap with nearly any skill invoked on those systems. It sits between the 'somewhat specific but could still overlap' (3) and 'very broad; high overlap risk' (2) anchors; the specific 'what' keeps it at 3 rather than 2.

3 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

sickn33/agentic-awesome-skills

Path

skills/bash-linux/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.