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.
65
Quality
62%
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 framework). 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
Consider adding file extension triggers like '.bats files' or mentioning 'bats-core' for additional keyword coverage
| 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 | Includes good natural keywords users would say: 'Bats', 'shell script testing', 'tests', 'CI/CD pipelines', 'test-driven development', 'shell utilities'. These cover common variations of how users would request this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche targeting Bats framework specifically for shell script testing. The combination of 'Bats', 'shell script testing', and 'shell utilities' creates a distinct trigger profile unlikely to conflict with general testing or scripting skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%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 table of contents rather than actionable guidance. It lacks any concrete code examples, specific Bats syntax, or executable commands, deferring all substantive content to external resources. The instructions are too abstract to be useful without consulting the referenced playbook.
Suggestions
Add a minimal executable Bats test example directly in the skill (e.g., a simple @test block with assertions)
Replace abstract instructions like 'Write tests for exit codes' with specific Bats commands and patterns
Include at least one concrete setup/teardown example with actual Bats syntax
Provide a quick-start section that allows immediate use without requiring external file navigation
| 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, set up, write, add, run) but no validation checkpoints, no feedback loops for error recovery, and the steps are too high-level to guide actual implementation. | 2 / 3 |
Progressive Disclosure | References to external resources exist and are one level deep, but the main skill file provides almost no standalone value - it's essentially just a pointer to implementation-playbook.md with minimal overview content. | 2 / 3 |
Total | 7 / 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 | |
3395991
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.