CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bash-scripting

Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.

Quality

71%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/bash-scripting/SKILL.md

The canonical home for this skill is bash-scripting in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 presents a well-sequenced, seven-phase workflow with a clean structure, a practical executable template, and a quality-gates checklist, but most phases instruct at the level of action labels rather than concrete code, and the many @-referenced companion skills are neither bundled nor explained. Tightening the phase actions into concrete snippets or moving detail into reference files would strengthen both actionability and organization.

Suggestions

Replace action-label steps (e.g. 'Add trap handlers', 'Implement retry logic') with concrete inline code snippets, or move them into bundled reference files with real commands.

Clarify the @-referenced skills (bash-pro, bats-testing-patterns, shellcheck-configuration): either include them in the bundle (e.g. a references/ directory) or state what they are and where they live.

Add explicit feedback loops, e.g. 'Run ShellCheck; if it reports issues, fix them and re-run before proceeding to documentation' in Phase 6 and the Quality Gates section.

DimensionReasoningScore

Conciseness

The body is almost entirely lists and code with no conceptual padding (it never explains what bash or ShellCheck is), so every token mostly earns its place. Minor trimmable redundancy exists — the per-phase "Copy-Paste Prompts" largely duplicate the "Skills to Invoke" lines, and the template's "# Implementation" placeholder adds little — keeping it below the lean 5 anchor.

4 / 5

Actionability

One fully executable artifact exists (the set -euo pipefail script template), but the seven phases offer only high-level directives like "Add trap handlers", "Implement retry logic", "Configure log rotation" with no concrete code or commands for those steps, and the @-referenced skills (bash-pro, bats-testing-patterns, etc.) are not part of this bundle. That mix of one complete template plus incomplete pseudolevel guidance matches the 3 anchor better than the mostly-executable 4.

3 / 5

Workflow Clarity

The seven phases form a clear design-to-documentation sequence with a terminal Quality Gates checklist (ShellCheck passes, Bats tests pass) acting as validation, and Phase 6 embeds testing into the flow. It falls short of the 5 anchor because there are no explicit feedback loops (e.g. 'if ShellCheck fails, fix and re-run before proceeding') — checkpoints are listed but the validate-fix-retry cycle is only implicit.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so the 187-line body is a single self-contained file. It has good section headers, but the "Related Workflow Bundles" and "Skills to Invoke" entries point to other skills without signaling what or where they are, and per-phase detail that could live in separate reference files is all inline — matching the 3 anchor (structure present, organization could be improved).

3 / 5

Total

14

/

20

Passed

Description

66%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 solid but incomplete description: it clearly states what the skill does with concrete capability areas and natural bash/shell keywords, but it omits any explicit "Use when..." trigger guidance, which caps its completeness and limits when Claude would reliably select it. Adding a trigger clause and file-extension terms would lift it substantially.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g. 'Use when creating bash scripts, automation scripts, or .sh files, or when the user mentions shell scripting or hardening a script with error handling.'

Include natural trigger variations such as '.sh', 'shell', and 'automation script' alongside 'bash' and 'shell scripts'.

Sharpen the action list slightly (e.g. 'write, harden, and test bash scripts') so it reads as discrete actions rather than a workflow label with attributes.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "creating production-ready shell scripts", "defensive patterns, error handling, and testing" — which go beyond naming the domain, but they are attributes of a workflow rather than the multiple discrete actions (extract, fill, merge, convert) of the 5 anchor. It sits above the 1-2 action coverage of the 3 anchor, so 4 fits best.

4 / 5

Completeness

The "what" is clear (production-ready shell scripts with defensive patterns, error handling, testing) but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It clearly matches the 3 anchor (clear what, missing when).

3 / 5

Trigger Term Quality

Natural terms users would say are present: "bash scripting", "shell scripts", "error handling", "testing". However, common variations like ".sh", "shell", "automation script", or "write a script" are missing, so it does not reach the comprehensive synonym/extension coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

"Bash scripting workflow" carves out a clear niche (bash/shell script creation) that is mostly distinct from PDF, git, or document skills, with only minor overlap risk against closely related general scripting or CI/CD skills. It is not distinctive enough on trigger phrasing alone to warrant 5.

4 / 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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/bash-scripting/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.