Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.
72
66%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agent/skills/bats-testing-patterns/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description with excellent completeness and distinctiveness. It clearly identifies when to use the skill and targets a specific niche (Bats testing). The main weakness is the lack of specific concrete actions - it says 'comprehensive shell script testing' but doesn't enumerate what specific testing capabilities it provides.
Suggestions
Add specific concrete actions like 'write test cases, mock commands, assert exit codes and outputs, set up test fixtures' to improve specificity
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Bats, shell script testing) and mentions some contexts (CI/CD pipelines, test-driven development), but lacks specific concrete actions like 'write test cases', 'mock commands', 'assert outputs', or 'generate test reports'. | 2 / 3 |
Completeness | Clearly answers both what ('Master Bash Automated Testing System for comprehensive shell script testing') and when ('Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Good coverage of natural terms: 'Bats', 'shell script testing', 'tests', 'shell scripts', 'CI/CD pipelines', 'test-driven development', 'shell utilities' - these are terms users would naturally use when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on Bats testing framework for shell scripts - distinct from general shell scripting skills, general testing skills, or other testing frameworks. The combination of 'Bats' + 'shell script testing' creates a unique trigger profile. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill functions primarily as a pointer to external resources rather than providing actionable guidance itself. While the progressive disclosure structure is good, the main content lacks any concrete code examples, specific Bats syntax, or executable commands. The instructions read as a high-level checklist rather than practical guidance Claude can act on.
Suggestions
Add at least one concrete, executable Bats test example showing basic syntax (e.g., @test block, assertions, setup/teardown functions)
Replace vague instructions like 'Write tests for exit codes, output, and side effects' with specific code patterns or commands
Include a minimal quick-start code block that demonstrates a complete working test file structure
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is relatively brief but includes some unnecessary sections like 'Use this skill when' and 'Do not use this skill when' that explain obvious contexts Claude can infer. The actual instructions are lean but the framing adds padding. | 2 / 3 |
Actionability | The instructions are vague and abstract ('Confirm shell dialects', 'Set up a test structure', 'Write tests for exit codes') with no concrete code examples, commands, or executable guidance. Everything actionable is deferred to external resources. | 1 / 3 |
Workflow Clarity | There is a basic sequence of steps (confirm dialects → set up structure → write tests → add setup/teardown → run in CI), but no validation checkpoints, no feedback loops, and the steps are too high-level to guide actual implementation. | 2 / 3 |
Progressive Disclosure | The skill appropriately serves as an overview pointing to detailed resources with clear one-level-deep references to 'resources/implementation-playbook.md' and the sub-skills section. Navigation is well-signaled. | 3 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
332e58b
Table of Contents
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.