CtrlK
BlogDocsLog inGet started
Tessl Logo

shell-scripting

Shell scripting expert for Bash, POSIX compliance, error handling, and automation

60

Quality

68%

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 ./crates/openfang-skills/bundled/shell-scripting/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

87%

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 excellent, concise, executable reference for shell-scripting best practices with copy-paste-ready code and clean section organization. Its only weakness is that it is a technique catalog rather than a sequenced workflow with validation checkpoints, which keeps workflow clarity at 2.

DimensionReasoningScore

Conciseness

The body is lean and dense with actionable bullets like "Start every Bash script with `set -euo pipefail`" and "Quote all variable expansions", with no padding explaining basic concepts Claude already knows; every token earns its place.

3 / 3

Actionability

It provides copy-paste-ready, executable guidance throughout, e.g. "`${var:-default}`", "tmpfile=$(mktemp) && trap \"rm -f $tmpfile\" EXIT", and a complete log() function, rather than pseudocode or vague direction.

3 / 3

Workflow Clarity

It lists well-organized techniques and mentions validation ("Validate inputs at the top of the script") and cleanup traps, but presents a catalog of techniques rather than a sequenced multi-step workflow with explicit validation checkpoints or feedback loops.

2 / 3

Progressive Disclosure

The skill is under 50 lines with no bundle files and no need for external references, and is cleanly organized into Key Principles, Techniques, Common Patterns, and Pitfalls sections, meeting the bar for a score of 3.

3 / 3

Total

11

/

12

Passed

Description

50%

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 clearly identifies the shell-scripting domain and several capability areas, but reads as a topic list rather than concrete actions and lacks any "Use when..." trigger guidance. It is competent but generic enough to risk overlap with adjacent automation skills.

Suggestions

Reword as concrete actions, e.g. "Write, debug, and harden Bash and POSIX shell scripts with error handling, traps, and portable syntax".

Add an explicit trigger clause such as "Use when writing or debugging shell scripts, automating CLI tasks, or needing POSIX-portable scripts".

Include natural trigger variations users say ("bash script", "shell script", "POSIX sh", "portable script") to improve trigger coverage.

DimensionReasoningScore

Specificity

Names a clear domain ("Shell scripting expert") with several capability areas ("Bash, POSIX compliance, error handling, and automation"), but describes topics rather than concrete actions, so it does not reach the level of listing multiple specific actions.

2 / 3

Completeness

It answers "what" the skill does but lacks any "Use when..." clause or equivalent explicit trigger guidance, which per the guidelines caps completeness at 2.

2 / 3

Trigger Term Quality

"Bash", "shell scripting", and "automation" are natural terms a user would say, but common variations like "shell script", "write a bash script", "POSIX sh", or "portable script" are missing, so coverage is partial.

2 / 3

Distinctiveness Conflict Risk

"Shell scripting" is a fairly clear niche, but the broad term "automation" could overlap with other scripting/automation skills, so it is only somewhat specific.

2 / 3

Total

8

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
RightNow-AI/openfang
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.