CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-code-bash-patterns

Claude Code Bash tool patterns with hooks, automation, git workflows. Use for PreToolUse hooks, command chaining, CLI orchestration, custom commands, or encountering bash permissions, command failures, security guards, hook configurations.

69

1.07x
Quality

69%

Does it follow best practices?

Impact

72%

1.07x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/claude-code-bash-patterns/skills/claude-code-bash-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 well-structured with clearly signaled, one-level-deep references and largely executable examples, but it is padded with redundant, trivially-known bash content and repeats the same git chain across five sections. Workflow guidance lists steps but omits explicit validation checkpoints for push/deploy operations, and the bundle navigation is undermined by a nonexistent templates/ directory and unmentioned scripts/ files.

Suggestions

Collapse the duplicated git-commit / background-process examples into a single section and remove content Claude already knows (e.g. `ls -la`, quoting paths with spaces) to cut token cost substantially.

Insert explicit validation checkpoints into workflows (e.g. run tests, check exit code, only then push/deploy) so destructive or batch operations include feedback loops.

Fix bundle navigation: remove or actually create the missing templates/ files, and add a section pointing to the existing scripts/ helpers (dangerous-command-guard.py, package-manager-enforcer.sh).

DimensionReasoningScore

Conciseness

The body is noticeably verbose and redundant for an audience that already knows bash: a Quick Start whose 'Basic Command' is `ls -la`; the same `git add . && git commit` chain repeated across Quick Start, Five Core Patterns, Git Workflows, Common Use Cases, and Examples; `npm run dev &` shown twice; and a Troubleshooting entry ('Quote the path') restating the Critical Rules. It also carries time-sensitive metadata ('Last Verified: 2025-11-18', version 2.0.0) outside any deprecated/old-patterns section. This matches anchor 2 (several unnecessary or padded sections), not anchor 3, because the redundancy spans multiple whole sections rather than isolated trimmable sentences.

2 / 5

Actionability

Most guidance is copy-paste executable: concrete command chains, a runnable PreToolUse hook script with shebang, a settings.json snippet, and a custom-command markdown template. Minor gaps keep it at anchor 4 rather than 5: the 'Parallel Operations' pattern is a placeholder ('Message with multiple Bash tool calls in parallel') rather than executable content, and the first Quick Start hook snippet is a stub compared to the full version later.

4 / 5

Workflow Clarity

Multi-step sequences are listed (feature-branch workflow, test-then-commit, deploy-with-validation), but validation checkpoints are absent or merely implied — 'Check exit codes' and 'Handle errors explicitly' appear as bare bullet rules with no validate-then-proceed step in any workflow. Per the rubric's cap, git push / deploy workflows involving destructive or batch operations without explicit validation cannot score above 3, so this is anchor 3 (sequence present, checkpoints missing) rather than anchor 4.

3 / 5

Progressive Disclosure

Structure is present and references to the five references/ files are well signaled (dedicated 'When to Load References' section, one level deep, all files verified to exist). However, the 'Using Bundled Resources' section advertises a templates/ directory with five files that does not exist in the bundle, and the three scripts/ files (bash-audit-logger.sh, dangerous-command-guard.py, package-manager-enforcer.sh) are never mentioned in the body at all, leaving real bundle content undiscoverable. These are substantive navigation defects, so it sits at anchor 3 rather than anchor 4's 'minor organization gaps'.

3 / 5

Total

12

/

20

Passed

Description

75%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: third-person, domain-scoped, with an explicit 'Use for...' trigger clause covering concrete scenarios like PreToolUse hooks, command chaining, and bash permission failures. Its main gap is that the 'what' portion enumerates pattern areas rather than concrete actions, and a few natural trigger synonyms are absent.

Suggestions

Convert the 'what' clause into concrete actions (e.g. 'Chains commands with &&, configures PreToolUse hooks, automates git commit/PR workflows') to raise specificity and completeness.

Add natural trigger synonyms users might say, such as 'shell commands', 'terminal automation', or 'CI/CD pipeline', to improve trigger coverage.

Consider trimming overlapping trigger phrases ('hook configurations' largely duplicates 'PreToolUse hooks') for a tighter description.

DimensionReasoningScore

Specificity

The description names the domain ('Claude Code Bash tool patterns') and several concrete capability areas ('hooks, automation, git workflows', 'command chaining, CLI orchestration, custom commands'). It matches anchor 4 (several specific actions, minor coverage gaps) but not anchor 5, because it describes pattern areas rather than a comprehensive list of concrete actions like 'extract text, fill forms, merge documents'; it is well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Both parts are present: 'what' ('Bash tool patterns with hooks, automation, git workflows') and an explicit 'Use for...' trigger clause ('PreToolUse hooks, command chaining, ... bash permissions, command failures'). The 'when' is explicit, but the 'what' is a summary of pattern areas rather than a crisp list of concrete actions, so it matches anchor 4 ('when' could be more specific / 'what' less explicit) rather than anchor 5's fully concrete pairing, and is clearly above anchor 3 where 'when' is missing or weakly implied.

4 / 5

Trigger Term Quality

Phrases like 'PreToolUse hooks', 'command chaining', 'bash permissions', 'command failures', 'git workflows', and 'custom commands' are natural terms a user would say. Coverage is good but missing common variations and synonyms (e.g. 'shell commands', 'terminal', 'CI/CD', 'automation scripts'), so it fits anchor 4 rather than anchor 5's comprehensive synonym/extension coverage, and clearly exceeds anchor 3's partial keyword coverage.

4 / 5

Distinctiveness Conflict Risk

The scope is narrowly pinned to 'Claude Code Bash tool' with distinct triggers (PreToolUse hooks, hook configurations, bash permissions), giving it a clear niche with minimal conflict risk against unrelated skills. Minor overlap remains with generic git-workflow or hooks-specific skills, so it fits anchor 4 rather than anchor 5, and is far more distinguishable than anchor 3's 'somewhat specific'.

4 / 5

Total

16

/

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/claude-code-bash-patterns/skills/claude-code-bash-patterns/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.